Examples

Runnable examples live in examples/.

Basic Agent

python examples/basic_agent.py

Uses CallableLLM to demonstrate the smallest useful agent setup.

Tools

python examples/agent_with_tools.py

Registers a calculator tool and uses a deterministic test LLM that first requests the tool, then responds with the tool result.

Memory

python examples/agent_with_memory.py

Uses InMemoryMemory to show how prior interactions can be recalled into the prompt.

python-rag-framework

python examples/rag_integration.py

Creates a real rag.RAG instance, ingests text, retrieves context and passes it to the runtime prompt.

Install the backend first:

uv add "python-rag-framework @ git+https://github.com/lelouchzr/python-rag-framework.git@v0.1.0"

OpenAI

python examples/openai_adapter.py

Requires:

uv add "python-agent-runtime[openai]"
export OPENAI_API_KEY=...