Skip to content

symfonic-core

The Agent Graph Framework. Build AI agents with a five-layer Hierarchical Memory System, streaming, tool routing, fabrication detection, and durable persistence — all default-preserving, so you adopt one knob at a time.

  • Get started in minutes

    Install the package, run your first agent, and scaffold a full project.

    Quickstart

  • Understand the model

    The agent, the 5-Pentad memory system, streaming, and the runtime graph.

    Core Concepts

  • Every feature, mapped

    One page listing all 11 capability clusters with minimal and opt-in snippets.

    Feature Catalog

  • Reference the source

    Auto-generated API docs for every public module, always in sync with the code.

    API Reference

Install

pip install symfonic-core

Add the provider you use as an extra:

pip install "symfonic-core[anthropic]"

pip install "symfonic-core[openai]"

pip install "symfonic-core[google]"

pip install "symfonic-core[aws]"

pip install "symfonic-core[openrouter]"

pip install "symfonic-core[ollama]"

Your first agent

from symfonic.agent.config import FrameworkConfig
from symfonic.agent.engine import SymfonicAgent
from symfonic.core.testing import MockModelProvider

agent = SymfonicAgent(
    model_provider=MockModelProvider(response="Hello!"),
    config=FrameworkConfig(),  # HMS off — the simplest path
)

print(agent.run("Hi there"))

FrameworkConfig() with no arguments reproduces pre-upgrade behaviour byte-for-byte. Every capability in the Feature Catalog is opt-in from there.

Where to go next

I want to… Start here
Run an agent and stream its output Quickstart · Streaming & Callbacks
Give my agent durable memory Memory & Persistence · Memory concept
Add tools and route to them Intent & Tool Routing · Lazy Tooling
Build a business domain plugin Plugins & Domains
Ship to production Production · Production Adopter Pattern
Scaffold a full app Scaffold a Project · Store Starter