Status: alpha — APIs may change. Pin an exact version in production and read the CHANGELOG before upgrading.
Write AI agents in Python (and soon other languages) that run inside the Friday platform. The host manages credentials and routes LLM, HTTP, and MCP calls on the agent's behalf, so your agent code stays a pure Python function — no provider SDKs, no key plumbing.
Requirements (the SDK is not standalone):
-
Python 3.12+
-
A running Friday daemon (provides the
atlasCLI and the host runtime) -
An LLM provider key (Anthropic, OpenAI, or Google) configured in the daemon's
.env— agents never see it directly -
SDK reference & guides:
packages/python/README.mdandpackages/python/docs/ -
Examples:
packages/python/examples/— 10 runnable agents from minimal to production-grade -
Friday platform docs: https://docs.hellofriday.ai/
-
Daemon &
atlasCLI: friday-platform/friday-studio
This is a monorepo. The product is the Python package under
packages/python/; the TypeScript root is dev tooling
(Vite+) for running checks across the workspace.
pip install friday-agent-sdkThen see packages/python/README.md to write
and run your first agent.
Please read CONTRIBUTING.md. Security issues: see SECURITY.md.