تثبيت كيل — من المصدر أو من إصدارات GitHub

جرّبه في خمس دقائق — من المصدر

كلُّ ما في هذا المسار للقراءة فقط ومن جهة التداول الافتراضي (paper): لا أموال، ولا شيء هنا يستطيع تقديم أمر تداول. تحتاج uv ومفتاح API لمنصّة Coinbase Developer Platform‏ (CDP) مجانيًّا للقراءة فقط — تُجلب بيانات الشموع عبر العميل المُصادَق، لذا يفشل keel fetch من دون مفتاحٍ بخطأ AuthenticationError؛ نقولها مقدمًا كي لا تكون مفاجأةً في الخطوة الرابعة.

• ‏uv (مدير حزم Python)
• أي Python من 3.11 فما فوق (المستودع يُطوَّر على 3.14)
• مفتاح CDP مجاني للقراءة فقط — لبيانات السوق حصرًا

git clone https://github.com/CodeGateSoftware/keel.git && cd keel
uv sync --all-extras --dev        # any Python 3.11+ (the repo develops on 3.14)
cp .env.example .env              # put the read-only CDP key/secret in it — market data only
uv run keel rules seed            # register the rule families as candidates
uv run keel fetch                 # pull candle history for the default allowlist
uv run keel simulate --years 1 --skip-within-cap

ما يجب أن تتوقّع

يعيد keel simulate تشغيل القواعد الحقيقية حتميًّا فوق التاريخ المجلوب، ويقارنها بمقياس DCA، ويكتب تقرير GO-LIVE أو TRAIN-MORE. وعلى القواعد الافتراضية سيخبرك على الأرجح TRAIN MORE ويسمّي البوابات الفاشلة — فهذا المحرّك يعمل، لا أنه معطّل؛ الصدق هو الخصيصة.

الخطوات التالية — ترقية قاعدةٍ عبر البوابة، وتشغيل الوكيل الافتراضي، وأول أمرٍ حيٍّ خاضعٍ لإشراف بشري — في كتاب الانتقال إلى الحيّ (go-live runbook). →

تثبيت إصدار

تُسلَّم الإصدارات مجموعاتِ عجلاتٍ على GitHub Releases. الأزرار أدناه تربط مباشرةً ب GitHub — وهذا الموقع لا ينسخ الملفات التنفيذية أبدًا.

pip install --find-links . ./keel_trader-0.10.0-py3-none-any.whl

1. نزّل كل العجلات إلى مجلدٍ واحد

   خذ كل عجلةٍ من صفحة أحدث إصدار إلى مجلدٍ واحد (الأزرار أدناه تربط بها — لا بنسخةٍ معكوسة أبدًا).

2. ثبّت keel_trader بالمسار

   ‏pip install --find-links . ./keel_trader-<الإصدار>-py3-none-any.whl — الأمر الدقيق للإصدار الحالي في اللوحة أعلاه.

   pip install --find-links . ./keel_trader-0.10.0-py3-none-any.whl

3. تحقّق بـ keel versions — لا بـ --version

   يعرض keel versions كل توزيعات كيل في البيئة الافتراضية ويخرج بخطأٍ إن بقيت توزيعةٌ شقيقةٌ على إصدارٍ أقدم — وهو ما لا يراه --version.