anee769/conduitبوابة API محلية (On-prem) لوكلاء الترميز بالذكاء الاصطناعي مع توزيع التكاليف لكل مهندس، وميزانيات صارمة، وحوكمة البيانات الصادرة (فحص الأسرار/الكيانات)، ومراقبة دوران السياق، وتصدير جاهز للتدقيق. يعمل داخل شبكة VPC الخاصة بك.
لوحة التحكم المحلية (on-prem) لعملاء الترميز بالذكاء الاصطناعي. إسناد التكلفة لكل مهندس · ميزانيات صارمة · حوكمة الصادر (egress) · مراقبة تدهور السياق (context rot) · تقارير جاهزة للتدقيق — كل ذلك داخل شبكتك الافتراضية الخاصة (VPC).
Conduit يقع بين عملاء الترميز بالذكاء الاصطناعي لديك (Claude Code، Cursor، Codex، Aider) وأي مزود تستخدمه بالفعل (Anthropic، OpenAI، Bedrock، Azure — أو نشرك الحالي LiteLLM / Portkey). متغير بيئة واحد للاعتماد، بدون تغييرات على العميل، ولا يتم تخزين المطالبات (prompts) والإكمالات (completions) أبدًا.
[Claude Code / Cursor / Codex]
│ ANTHROPIC_BASE_URL=https://conduit.yourco.dev
▼
[Conduit] vk_live_… (لكل مهندس)
│ القياس · الميزانيات · الحوكمة · التدقيق · تدهور السياق
▼
[LiteLLM / Portkey / المزودون المباشرون]
│
▼
[Anthropic / OpenAI / Bedrock / Azure]
نظرة عامة — الإنفاق، توفير الذاكرة المخبأة، الرموز (tokens)، الطلبات المحظورة، وإشارات الحوكمة في لمحة.
فرض الميزانية الصارمة — تجاوز الحد يعيد 402 عند البوابة (gateway)، قبل أن يصل الطلب إلى المزود.
حوكمة الصادر — يتم حظر طلب يحمل مفتاح AWS برمز 451؛ يتم تسجيل الفئة فقط، ولا يتم تسجيل القيمة أبدًا.
النشاط — كل طلب بحالة مميزة: نجاح · إصابة ذاكرة تخزين مؤقت · تحديد معدل · حظر نموذج · تجاوز ميزانية · حوكمة محظورة.
الإعدادات — إدارة كاملة (CRUD) للمؤسسة، بيانات اعتماد المزود، الفِرق، الميزانيات، والمفاتيح الافتراضية.
نقاط النهاية الخاصة لـ Bedrock / Vertex / Azure واتفاقيات BAA (بدون تدريب) تحل قناة الوصول إلى البائع. لكنها لا تخبر المالية (finance) من الذي أنفق الـ 40 ألف دولار، ولا تكتشف الأسرار عند الصادر، ولا تعطي المدققين سجلاً، ولا تُظهر أين يحرق تدهور السياق ميزانية الرموز الخاصة بك. هذه هي الفجوة التي يملؤها Conduit — دون أن يطلع على مطالباتك أبدًا.
يسحب أحدث الصور الموقّعة من GHCR (قابلة للتحقق عبر cosign verify، انظر الوضع الأمني).
# 1. احصل على ملف compose + قالب env (لا حاجة لاستنساخ كامل)
curl -fsSL https://raw.githubusercontent.com/anee769/conduit/master/docker-compose.yml -o docker-compose.yml
curl -fsSL https://raw.githubusercontent.com/anee769/conduit/master/.env.example -o .env
# 2. أنشئ مفتاح تشفير رئيسي حقيقي
sed -i.bak "s|^MASTER_ENCRYPTION_KEY=.*|MASTER_ENCRYPTION_KEY=$(openssl rand -base64 32)|" .env && rm .env.bak
# 3. اسحب الصور الموقّعة + ابدأ
docker compose --profile app pull
docker compose --profile app up -d
# 4. قم بتشغيل الترحيلات + زرع جدول التسعير (مرة واحدة)
docker exec conduit-gateway-1 pnpm --filter @finops/db db:migrate
docker exec conduit-gateway-1 pnpm --filter @finops/db seed-pricing
# → افتح http://localhost:3000/setup → أنشئ المؤسسة / بيانات الاعتماد / الفريق / المفتاح الافتراضي
ثبّت إصدارًا محددًا بتصدير GATEWAY_IMAGE و CONTROL_PLANE_IMAGE قبل up:
export GATEWAY_IMAGE=ghcr.io/anee769/conduit-gateway:v0.1.0
export CONTROL_PLANE_IMAGE=ghcr.io/anee769/conduit-control-plane:v0.1.0
git clone https://github.com/anee769/conduit && cd conduit
cp .env.example .env
sed -i.bak "s|^MASTER_ENCRYPTION_KEY=.*|MASTER_ENCRYPTION_KEY=$(openssl rand -base64 32)|" .env && rm .env.bak
docker compose --profile app up -d --build
docker exec conduit-gateway-1 pnpm --filter @finops/db db:migrate
docker exec conduit-gateway-1 pnpm --filter @finops/db seed-pricing
export ANTHROPIC_BASE_URL=http://localhost:4000
export ANTHROPIC_AUTH_TOKEN=vk_live_… # المفتاح الافتراضي من /setup
claude # أو cursor / codex / aider
دليل كامل من الصفر في INSTALL.md.
| تشغّله اليوم | هيّئ الوجهة النهائية لـ Conduit كـ |
|---|---|
| LiteLLM (أي نموذج، أي مزود) | UPSTREAM_ANTHROPIC_URL=http://litellm:4000 → الدليل الكامل: docs/run-with-litellm.md |
| Portkey | وجّه UPSTREAM_OPENAI_URL / UPSTREAM_ANTHROPIC_URL إلى رابط Portkey الأساسي الخاص بك |
| Anthropic / OpenAI مباشر | الإعداد الافتراضي — لا شيء لتكوينه |
| AWS Bedrock | هيّئ بيانات اعتماد Bedrock في /setup؛ Conduit يوقّع الطلبات بـ SigV4 |
| Azure OpenAI | هيّئ بيانات اعتماد Azure (اسم النشر + api-version) في /setup |
| Conduit | LiteLLM | Portkey | Helicone | |
|---|---|---|---|---|
| رخصة مفتوحة المصدر | Apache 2.0 | MIT | Apache 2.0 (البوابة) | MIT |
| يعمل بالكامل محليًا / في شبكتك الخاصة | ✅ | ✅ | ✅ (مؤسسي) | ✅ (استضافة ذاتية) |
| توجيه المزود + تسميات (aliasing) + احتياطي (fallback) | ✅ (أي وجهة نهائية) | ✅ | ✅ | ❌ |
| إسناد التكلفة لكل مهندس (مفاتيح افتراضية بأسماء) | ✅ | جزئي (فواتير مشتركة لمفتاح رئيسي) | ✅ | ✅ (مراقبة فقط) |
| ميزانيات صارمة (إرجاع 402 عند الفشل) | ✅ | جزئي | ✅ | ❌ |
| حوكمة الصادر (أسرار + قائمة سماح كيانات للمؤسسة، تنبيه ← حظر) | ✅ | ❌ | ✅ (حواجز حماية) | ❌ |
| تصدير جاهز للتدقيق (CSV/JSON) (بيانات وصفية فقط) | ✅ | ❌ | جزئي | ✅ |
| مراقبة تدهور السياق (منحنى التكلفة والخطأ حسب حجم رمز الإدخال) | ✅ | ❌ | ❌ | ❌ |
| لا يتم تخزين المطالبات / الإكمالات أبدًا | ✅ | يسجل افتراضيًا | قابل للتكوين | يسجل افتراضيًا |
| إصدارات موقّعة + SBOM (CycloneDX) | ✅ | ❌ | ❌ | ❌ |
| مصمم للوقوف فوق الآخرين | ✅ | غير قابل للتطبيق | غير قابل للتطبيق | غير قابل للتطبيق |
LiteLLM ممتاز في تسميات النماذج وتوجيهها — Conduit يضيف الطبقة التي طلبتها فرق الأمان والمالية لديك. Portkey هو الأقرب في تغطية الميزات لكنه مغلق المصدر على مستوى المؤسسات بمجرد احتياجك للحوكمة والنشر المحلي. Helicone هو للمراقبة فقط (يخبرك أين ذهبت الرموز؛ لا يتحكم في أين تذهب).