المصدر المفتوح، ترخيص معهد ماساتشوستس للتكنولوجيا

تثبيت free-code، وكيل الترميز الذكاء الاصطناعي الحر لطرفيتك

يقوم برنامج free-code بقراءة مشروعك، وتحرير الملفات مع مقارنة الموافقة عليها، وتشغيل اختباراتك وإصلاح ما يفشل. سطر واحد يقوم بتركيب على macOS، Linux أو Windows.

macOS / Linux / WSL
curl -fsSL https://free.ai/install.sh | sh
Windows (PowerShell)
irm https://free.ai/install.ps1 | iex

لا يحتاج إلى حقوق Python أو pip أو admin أولاً. أطلق نفس السطر مرة أخرى للارتقاء.

مجاني للبدء: 6,000 tokens يوميا بدون حساب، 30,000 يوميا مع حساب مجاني مؤكد.

طرق أخرى للتثبيت

The one-line installer uses uv, then pipx, then a private Python environment, whichever works first. If you already use one of these tools, install the freeai-code package directly:

uv tool install freeai-code
pipx install freeai-code
pip install freeai-code
npm install -g freeai-code

تحتاج حزمة npm إلى بيثون 3.9 أو أحدث على الجهاز.

تثبيت نسخة محددة

# macOS / Linux
curl -fsSL https://free.ai/install.sh | FREE_CODE_VERSION=<version> sh

# Windows (PowerShell)
$env:FREE_CODE_VERSION = "<version>"; irm https://free.ai/install.ps1 | iex

لإجبار طريقة واحدة للتثبيت، حدد FREE_CODE_INSTALLER إلى uv، pipx أو venv بنفس الطريقة.

تحقق من أنّه يعمل

free-code --version

المرحلة الأولى

افتح محطة طرفية في مجلد مشروعك وبدأ جلسة. إنها تعمل فوراً بدون حساب.

cd your-project
free-code

# Or one task at a time
free-code ask "How does the auth system work?"
free-code run "Add unit tests for the User model"

الوضع الآمن هو تشغيل افتراضي: ترى مقارنة وتوافق على كل ملف تعديل وأمر قبل تشغيله. في المرة الأولى، free-code يسأل مرة واحدة إذا كان إرسال تقارير الانهيار مجهولة الهوية. الإجابة الافتراضية هي لا.

مفاتيح الدخول و API

التسجيل يزيد من حصتك اليومية المجانية ويسمح لك باستخدام نماذج مدفوعة من رصيد رمزك. يفتح متصفحك على Free.ai، تضغط على موافقة، ويتلقى CLI مفتاحًا تلقائيًا.

free-code login               # opens your browser
free-code login --no-browser  # over SSH: approve from any device with a short code
free-code login --manual      # paste a key or choose your own provider
free-code logout              # forget the key on this machine

يمكنك أيضاً إنشاء مفتاح بنفسك في حسابك وتحديده، وهو أمر مفيد للخواديم و IC:

free-code config set token sk-free-...
# or, for one shell or a CI job
export FREE_CODE_TOKEN=sk-free-...

إنشاء حساب مجاني

استخدم مفتاح مقدم الخدمة الخاص بك

يعمل free-code أيضاً مع مفتاح OpenAI الخاص بك، أو Anthropic، أو Google أو OpenRouter. ثم تذهب الطلبات إلى ذلك المزود مع مفتاحك.

free-code config set provider anthropic
free-code config set api_key sk-ant-...

اختار نموذجاً

free-code يعرض كل نموذج Free.ai يخدم، نموذج المستوى الحر أولاً. نموذج المستوى الحر لا تكلف أي رموز في إطار حصتك اليومية؛ النموذج المدفوع يتم فاتورة في الرموز.

free-code models               # chat models, free tier first
free-code models --free        # only models that cost no tokens
free-code models --type image  # image, video, tts, stt, ocr, music ...
free-code config set model <id>  # default model for new sessions

داخل جلسة، اكتب /model للتبديل. جميع النماذج

أوامر مشتركة

القيادةماذا يفعل
free-codeبدء جلسة تفاعلية في هذا المجلد
free-code -cاستئناف آخر جلسة لهذا المشروع
free-code ask "..."اسأل سؤالاً واحداً عن قاعدة الرمز
free-code run "..."تنفيذ مهمة ترميز واحدة
free-code -p "..."طباعة الإجابة والخروج، للنصوص والاتصالات المتبادلة
free-code sessionsقائمة الجلسات المحفوظة التي يمكنك استئنافها
free-code tools)ب( إظهار اﻷدوات التي يمكن للوكيل استخدامها والتي تحتاج إلى الموافقة عليها
free-code cloud "..." --repo URLتشغيل مهمة في Free.ai السحابة والحصول على تقرير
free-code tasksقائمة مهام السحابة الأخيرة
free-code rcشاهد وقود الجلسة من تطبيق Free.ai
free-code mcp addاتصال خادم MCP
free-code updateالارتقاء إلى أحدث إصدار
free-code configأظهر إعداداتك

بالإضافة إلى تحرير الملفات وتشغيل الأوامر، يمكن للوكيل توليد الصور، والكلمات، والموسيقى والفيديو في مشروعك، وتحرير الصوت، وقراءة النص من لقطات الشاشة وملفات PDF، والبحث على شبكة الإنترنت مع الاقتباسات وترجمة ملفات اللغة المحلية.

كل أمر وخيار في README على GitHub

تحديث وإزالة

تحديثات التطوير من خلال أي شيء تم تركيبه. لإزالته، استخدم نفس الأداة:

free-code update

uv tool uninstall freeai-code
pipx uninstall freeai-code
pip uninstall freeai-code
npm uninstall -g freeai-code

إذا أنشأ برنامج التثبيت بيئته الخاصة، قم بحذف مجلد.free-code في دليلك المنزلي وملف free-code في.local/bin. تعيش إعداداتك وجلساتك المحفوظة أيضاً في.free-code.

حل المشاكل

لم يتم العثور على الأمر

مجلد التثبيت ليس في PATH الخاص بك بعد. على ويندوز، افتح محطة طرفية جديدة. على macOS أو Linux، أضفها إلى ملف بيانات قشرة وفتح محطة طرفية جديدة:

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc   # or ~/.zshrc

الحد المجاني المجهول اليوم قد استُهلك

تشغيل رمز الدخول المجاني للدخول والحصول على الإعانة اليومية الأكبر لحساب مجاني، أو إضافة الرموز لاستخدام نماذج مدفوعة. انظر التسعير

لا يستطيع برنامج التثبيت تنزيل uv

بعض الشبكات تمنع astral.sh. تثبيت مع pipx أو pip بدلا من ذلك، أو وضع FREE_CODE_INSTALLER=venv لاستخدام الخاص بك Python 3.9 أو أحدث.

فشلت عملية python3 -m venv على نظام Debian أو Ubuntu

ضع حزمة python3-venv مع apt، ثم أطلق سطر التثبيت مرة أخرى.

ما زلت عالقاً؟ أكتب /feedback داخل free-code، أو افتح قضية على GitHub. GitHub issues

الأسئلة المتكررة

free-code هو وكيل الترميز Free.ai لطرفيتك. إنه يقرأ مشروعك، ويحرر الملفات مع مسبقة مقارنة، وتشغيل الأوامر والاختبارات، واستخدام نماذج Free.ai. إنه مفتوح المصدر تحت رخصة MIT.

نعم، يعمل بدون حساب على مخصص يومي مجاني. تسجيل الدخول مع رمز مجاني للدخول لزيادة المخصص اليومي. النموذج المدفوع يتم تحميلها في الرموز ويحتاج إلى رصيد في حسابك.

macOS, Linux and Windows. استخدم خط curl على macOS, Linux and WSL، وخط PowerShell على Windows. يستخدم المرفق uv، الذي يأخذ لغة Python مناسبة لك، لذلك لا يوجد شيء لتثبيته أولاً.

لا. يضع برنامج التثبيت الشفرة الحرة في مجلد.local/bin في دليل منزلك ولا يطلب أبداً حقوق الإدارة.

تشغيل تسجيل الدخول الرمز الحر. متصفحك يفتح في Free.ai، يمكنك التسجيل والضغط على الموافقة، وCLI يتلقى مفتاح تلقائيا. على خادم عبر SSH، استخدم تسجيل الدخول الرمز الحر -- no-browser والموافقة من أي جهاز مع الرموز القصيرة التي تطبع.

نعم. إستخدم مفتاح التسجيل --manual للصق مفتاح Free.ai أو اختر مقدم خدمة خاص بك (OpenAI، Anthropic، Google أو OpenRouter). ثم تذهب الطلبات إلى ذلك المزود مع مفتاحك.

تشغيل نماذج الرمز الحر لقائمة كل نموذج Free.ai يقدم، مع نماذج الطبقة الحرة أولا. أضف --free أو --paid إلى المرشح. التبديل داخل جلسة مع /model، أو وضع نموذج افتراضي مع free-code config set model يليه نموذج id.

تعديل الملف والأوامر تجري على جهازك. النموذج يتلقى أجزاء من مشروعك التي تحتاج إلى الإجابة. تقارير الانهيار المجهولة هي مطفأة ما لم تشغلها، ولن تشمل أبداً شفراتك، أو التعليمات أو مسارات الملفات.

تشغيل تحديث الرمز الحر. يقوم بالتحديث من خلال أي شيء تم تركيبه: uv، pipx، pip أو npm. تشغيل خط التثبيت مرة أخرى أيضاً يقوم بالتحديث. مرة في اليوم يخبرك الرمز الحر عندما يكون هناك إصدار أحدث؛ لا يقوم بالتثبيت أبداً بنفسه.

Use the tool that installed it: uv tool uninstall freeai-code, pipx uninstall freeai-code, pip uninstall freeai-code or npm uninstall -g freeai-code. If the installer used its own private environment, delete the .free-code folder in your home directory and the free-code file in .local/bin.

نعم. free-code -p يتبعها مهمة تطبع الإجابة وتخلص. أضف --json لنتيجة JSON واحدة و --yes للسماح بتعديل الملفات. الأوامر الخطرة تظل محظورة حتى مع --yes، ورمز الخروج يخبرك إذا نجحت المهمة.

وهو يستخدم نفس حساب Free.ai. free-code rc يسمح لك بمراقبة وقيادة جلسة محطة من تطبيق Free.ai أو من صفحة الجلسات، و free-code cloud يقوم بتشغيل مهمة في Free.ai cloud ويقدم تقريرا.

ابدأ بالترميز مع الذكاء الاصطناعي في المحطة الطرفية

curl -fsSL https://free.ai/install.sh | sh

خيارات تثبيت ويندوز وغيرها · About Free.ai Coder

أحب Free.ai؟ أخبر أصدقائك!

تريد المزيد؟ سجل مجانًا: 30,000 رمز/يوم التسجيل مجانا

قيّم هذه الصفحة