مفتوح المصدر · Apache-2.0 · Python خالص

وجّه نماذج الذكاء الاصطناعي بقرارات قابلة للتحقق

ZYKO منصة تنسيق مفتوحة: توجيه بين OpenAI · Anthropic · Gemini · Groq · Mistral · DeepSeek · OpenRouter · Together AI · xAI · Ollama بإيصال توجيه قابل لإعادة التحقق، حوكمة Policy-as-Code، وكلاء أصليون بـ MCP — وتعمل أينما عملت: Linux · Windows · macOS · Android · Termux.

CI tests coverage security python license platforms MCP
zyko — first run, zero keys

01أربع ركائز تُميّز ZYKO

ليست بوابة أخرى — كل ركيزة تعالج فجوة حقيقية في أدوات التنسيق الموجودة اليوم.

توجيه قابل للتحقق

كل استجابة تحمل «إيصال توجيه»: ترتيب كامل للمرشحين بمكوّنات الدرجات والأوزان. أعد التحقق من أي قرار سابق دون اتصال.

جودة صادقة

درجات الجودة تأتي فقط من مقاييس مرجعية قابلة لإعادة الإنتاج ببذور ثابتة — لا من جداول تسويقية. بلا بيانات؟ 0.5 محايدة للجميع.

حوكمة شيفرة-كسياسة

سقف إنفاق يومي، حجب PII حتمي (بطاقات/إيميل/IBAN)، قوائم سماح للنماذج والأدوات، حدود معدل، وسجل تدقيق — في ملف YAML واحد.

MCP أولًا

ZYKO يستهلك خوادم MCP كأدوات لوكلائه، ويعرض نفسه كخادم MCP لأي مضيف — بروتوكول واحد يعمل في الاتجاهين.

02التثبيت على أي منصة

نواة Python خالصة (httpx + PyYAML فقط) — لا شيء يُترجم إلزامياً على أي منصة، بما فيها Termux.

$ pip install git+https://github.com/tibatechapp-ship-it/zyko.git

# first run — no keys, no network:
$ zyko ask "hello zyko" --demo --explain
$ zyko serve        # OpenAI-compatible gateway on :8787

كل أوامر CLI تعمل بلا مفاتيح عبر مزوّد العرض الحتمي المدمج — التوجيه والسياسات والإيصالات والبث كلها مسارات حقيقية.

03الحوكمة كملف واحد

سقف الإنفاق والحجب والسماح وحدود المعدل — ملف YAML واحد يُطبَّق على كل نداء، CLI ووكلاء وبوابة.

version: 1
name: strict
defaults:
  budget_usd_per_day: 2.0
  max_tokens_per_request: 2048
models:
  deny: ["*opus*"]
privacy:
  redact: [email, phone,
           credit_card, iban, ssn]
tools:
  deny: ["shell*"]
rate_limit:
  requests_per_minute: 30
zyko policy redact
$ zyko policy redact "card 4111 1111 1111 1111 mail bob@corp.com"
card [CREDIT_CARD] mail [EMAIL]

# deterministic PII redaction with Luhn check —
# enforced before any provider sees the prompt

04إيصال التوجيه — قرار يمكنك تدقيقه

كل نداء يمر عبر خط أنابيب واحد، وتحصل مع الإجابة على السجل الكامل للقرار.

الطلبprompt + سياسة
←
فحص السياسةحجب · سماح · ميزانية
←
الترجيحجودة × تكلفة × زمن
←
التنفيذمع بدائل عند الفشل
←
الإيصالJSON قابل للتدقيق
{
  "chosen": "openai/gpt-4o-mini",
  "strategy": "balanced",
  "ranking": [
    { "candidate": "openai/gpt-4o-mini",
      "total": 0.82, "quality": 0.74,
      "cost_score": 0.95, "latency_score": 0.88 },
    { "candidate": "ollama/llama3.1:8b",
      "total": 0.77, "quality": 0.61,
      "cost_score": 1.00, "latency_score": 0.70 }
  ]
}
أمرالوظيفة
zyko askإجابة + إيصال التوجيه
zyko routeخطة التوجيه فقط — بلا نداء API
zyko serveبوابة متوافقة مع OpenAI + بث SSE
zyko mcp serveاعرض ZYKO كخادم MCP
zyko benchالمقياس المرجعي القابل لإعادة الإنتاج
zyko runوكلاء من تعريف YAML بأدوات وMCP