إطار العمل

ابنِ وكلاءك على VAF.

المحرك نفسه الذي يدير تطبيق سطح المكتب — مكتبةَ Python. ‏pip install واحد، وAgent دون ارتباط بمزوّد، وأدواتك أنت، ورخصة تسمح بالنشر.

بداية سريعة

ثلاثة أسطر ويعمل الوكيل.

فئة Agent هي السطح المستقر لإطار العمل. الشيفرة نفسها تشغّل نموذج GGUF محليًا بالكامل (لا شيء يغادر الجهاز) أو أي مزوّد API مدعوم: ‏veyllo وopenai وanthropic وgoogle وdeepseek وopenrouter.

✓

البث المتدفق مدمج. مرر on_token فتصل الدفعات فور توليدها.

✓

المحادثات تدوم. يكتب save_session()‎ في مخزن الجلسات القياسي؛ أعد المعرف فتستأنف والذاكرة سليمة.

✓

أدواتك تُكتشف وحدها. ورّث من BaseTool أو انشر أداتك حزمة pip مستقلة — فيجدها الوكيل عند الإقلاع. وتُوصل خوادم MCP بالطريقة نفسها.

اقرأ دليل التضمين أمثلة قابلة للتشغيل

quickstart.py

from vaf import Agent

# a local GGUF model, or any API provider
agent = Agent(config={"provider": "local"})

answer = agent.run("Summarize my inbox.")
print(answer)

# stream tokens as they arrive
agent.run("Explain async/await.",
    on_token=lambda s: print(s, end=""))

# persist and resume a conversation
sid = agent.save_session()
agent = Agent(config={"provider": "local"}, session=sid)

رشيق افتراضيًا

ثبّت ما يحتاجه وكيلك فقط.

التثبيت الأساسي هو النواة وحِزم SDK للمزوّدين. أما الميزات الثقيلة فإضافات اختيارية؛ والأداة التي تنقصها إضافتها لا تُحمَّل ببساطة — ويستمر الوكيل بالعمل.

vaf[server]‏API عبر HTTP وWebSocket

vaf[desktop]نافذة سطح المكتب وشريط النظام

vaf[memory]ذاكرة RAG طويلة المدى (pgvector)

vaf[speech]تفريغ صوتي دون اتصال

vaf[browser]أدوات أتمتة المتصفح

vaf[pdf]استخراج PDF وOCR

vaf[docs]أدوات مستندات Office

vaf[all]كل شيء — بمستوى المنتج الكامل

الرخصة

أدواتك تبقى لك.

‏VAF مفتوح المصدر برخصة AGPL-3.0، مع إذن صريح فوقها: الإضافات والأدوات وتدفقات العمل التي تخاطب VAF عبر الواجهات العامة يمكن نشرها بالرخصة التي تختارها — حتى بشروط احتكارية. أما تضمين VAF نفسه في منتج مغلق أو SaaS فله رخصة تجارية.

‏pip install — ثم ابنِ.

يمر دليل التضمين خطوة بخطوة على الأدوات والجلسات والعمل غير المتزامن والتحزيم.

اقرأ دليل التضمين Get an API key