مفتوح المصدر · Apache 2.0 · Python 3.11+
Phronesis (φρόνησις): عند أرسطو هي الحكمة العملية - القدرة على التداول الجيد والتصرف بفطنة في مواقف ملموسة. يمتلك نموذج اللغة الكبير episteme (المعرفة). يحتاج الوكيل إلى phronesis.
from phronesis.agents import agent
from phronesis.providers import anthropic
@agent(
model=anthropic(model="claude-sonnet-4-6"),
system_prompt="You investigate questions thoroughly and cite sources.",
)
def researcher() -> str:
"""Investigate a question and synthesize a cited answer."""
result = await researcher.run("What is phronesis in Aristotelian ethics?")
print(result.output)from phronesis.agents import agent
from phronesis.providers import anthropic
@agent(
model=anthropic(model="claude-sonnet-4-6"),
system_prompt="You investigate questions thoroughly and cite sources.",
)
def researcher() -> str:
"""Investigate a question and synthesize a cited answer."""
result = await researcher.run("What is phronesis in Aristotelian ethics?")
print(result.output)لماذا Phronesis
تعرف نماذج اللغة الكبيرة أشياء - تلك هي الإبستيمي (episteme). لكن على الوكلاء أن يقرروا ويتصرفوا بفطنة في مواقف ملموسة. تلك هي الفرونسيس (phronesis). تعامل معظم أطر الوكلاء وكلاءها كروبوتات محادثة معززة ملصقة بحلقة استخدام أدوات. أما Phronesis فيتعامل معهم كأنظمة متداولة ذات عقود صريحة: مدخلات مطبَّعة، تأثيرات مُعلنة، ذاكرة محدودة، أنماط تنفيذ مُسمَّاة.
تفرض الأطر الحالية اختيارًا. من جهة، تكتب تدفق تحكم اعتباطيًا كشيفرة: أقصى تعبيرية ونظام متعدد الوكلاء لا يستطيع أحد تنقيحه بعد ستة أشهر. ومن جهة أخرى، يُوصف كل شيء بـ YAML أو بُناة رسوم بيانية: مقروء للوهلة الأولى، مستحيل بمجرد أن تحتاج شيئًا غير تافه. يفصل Phronesis المواصفة التعريفية عن التنفيذ في زمن التشغيل. الوكلاء والأدوات والذاكرة والأنابيب هي مواصفات مطبَّعة وثابتة وقابلة للتسلسل إلى JSON. تأتي أنماط التنفيذ من كتالوج مغلق ومُعرَّف جيدًا - تعبيرية دون فوضى.
كل تشغيل قابل للمراقبة عبر OpenTelemetry، وكل مواصفة قابلة للإصدار، وكل عقد فحص في زمن التشغيل، لا تعليق في موجِّه. هذا هو الفرق بين إطار ينتج عروضًا توضيحية وآخر ينتج أنظمة يمكنك تشغيلها.
By the numbers
A closed, named catalog - from Sequence and Parallel to Reflexion and Tree Search.
Every mode with a deterministic cassette, plus a full multi-agent mini-app.
Branch coverage gated at 90% - the build fails below the floor.
Agents, tools, memory, providers, MCP, pipelines, observability and more.
mypy --strict across the entire source tree, no escape hatches.
Permissive license, public roadmap, no enterprise gates.
جولة في الشيفرة
يربط الوكيل نموذجًا وأدوات وذاكرة تحت مواصفة تعريفية واحدة.
from phronesis import ToolEffect
from phronesis.agents import agent
from phronesis.providers import anthropic
from phronesis.tools import tool
@tool(effects=(ToolEffect.NETWORK,))
async def search_web(query: str, limit: int = 5) -> list[str]:
"""Search the web and return ranked snippets."""
...
@agent(
model=anthropic(model="claude-sonnet-4-6"),
tools=(search_web,),
system_prompt="You are a careful research assistant.",
max_iterations=8,
)
def assistant() -> str:
"""Answer questions grounded in live search results."""from phronesis import ToolEffect
from phronesis.agents import agent
from phronesis.providers import anthropic
from phronesis.tools import tool
@tool(effects=(ToolEffect.NETWORK,))
async def search_web(query: str, limit: int = 5) -> list[str]:
"""Search the web and return ranked snippets."""
...
@agent(
model=anthropic(model="claude-sonnet-4-6"),
tools=(search_web,),
system_prompt="You are a careful research assistant.",
max_iterations=8,
)
def assistant() -> str:
"""Answer questions grounded in live search results."""المبادئ
يُكوَّن الوكلاء من أجزاء - نموذج وأدوات وذاكرة وموجِّهات - لا عبر الفئات الفرعية. أنت تُجمِّع؛ لا تتجاوز.
البث والتزامن والإلغاء افتراضات أساسية. لا توجد واجهة برمجة متزامنة موازية لصيانتها.
Pydantic v2 في كل مكان. الأنواع ليست توثيقًا - بل عقود في زمن التشغيل يفرضها الإطار.
التعريفات قابلة للتسلسل إلى JSON وقابلة للاستنساخ. حالة التنفيذ تعيش منفصلة، قابلة للمراقبة والاستعلام.
فترات OpenTelemetry لكل تشغيل وكيل واستدعاء أداة ومرحلة أنبوب - من أول التزام، لا مُلصقة لاحقًا.
Sequence وParallel وReActLoop وConsensus وDebate وHandoff. أنماط مُسمَّاة يمكن الاستدلال عليها - لا تدفقات تحكم اعتباطية.
ماذا في الداخل
الأوّليّات التي يُبنى منها كل وكيل.
كيف يتذكر الوكلاء وماذا يتشاركون.
كيف يتشكل الوكلاء إلى أنظمة.
Engineering
mypy --strict and Pydantic v2 specs across the whole source tree. No untyped escape hatches.
1,600+ tests with branch coverage gated at 90% - the build fails below it, never above it on paper.
Record once, replay forever: cassette-backed runs make agent behavior reproducible in tests and CI without a network.
OpenTelemetry spans for every agent run, tool call, pipeline stage, and MCP session - correlated by stable ids.
Agents, tools, and pipelines are frozen, JSON-serializable dataclasses - versionable, diffable, reproducible.
ruff format and a strict ruff check gate every commit, alongside the type and test suites.
حالة المشروع
ستتغير واجهة البرمجة. نحن نعمل علنًا لبناء إطار يأخذ أنظمة الوكلاء على محمل الجد - مطبَّع، قابل للتركيب، قابل للمراقبة. لا ادعاءات إنتاج، ولا دراسات حالة مُختلقة، ولا بوابات مؤسسية. فقط الشيفرة والتزام صادق بتصميمها.
نرحب بالملاحظات والأفكار والمساهمات عبر GitHub Discussions وIssues. خارطة الطريق والنقاط الخشنة والأسئلة المفتوحة موجودة جميعها في المستودع.
