Reflexio Documentation
Agent self-improvement platform. Turns every conversation your AI agent has into a learning opportunity — automatically extracting user preferences and behavioral playbook entries so your agent continuously improves itself without manual tuning.
Reflexio
The moat for AI agents isn't the model — it's what your agent learns from every interaction it handles.
Reflexio is an agent self-improvement platform. It turns every conversation your AI agent has into a learning opportunity — automatically extracting user preferences and behavioral playbook entries so your agent continuously improves itself without manual tuning.
GitHub · reflexio-client on PyPI · reflexio-ai on PyPI
Install
Pick the package that matches how you want to run Reflexio:
Managed Reflexio Enterprise (recommended for most users) — lightweight client that talks to the hosted cloud at https://www.reflexio.ai. No local server, no extra dependencies.
pip install reflexio-clientSelf-hosted (open source) — full package containing the client, the FastAPI server, and the reflexio CLI. Use this when you want to run the entire Reflexio stack on your own machine.
pip install reflexio-aiBoth packages expose the same import:
from reflexio import ReflexioClient
client = ReflexioClient() # uses REFLEXIO_API_KEY env var (managed)
# or: client = ReflexioClient(url_endpoint="http://localhost:8081") # self-hostedQuick Start
Install and get running end-to-end in minutes.
Core Concepts
Understand interactions, profiles, playbooks, and evaluation.
API Reference
Complete client methods and schema documentation.
Examples
Code examples for common integration patterns.
Key Features
- Never Repeat the Same Mistake — Transforms user corrections and interaction signals into improved decision-making processes — so agents adapt their behavior and avoid repeating the same mistakes.
- Lock In What Works — Persists successful strategies and workflows so your agent reuses proven paths instead of starting from scratch.
- Correct in Real Time — Retrieves personalization and operational signals to fix agent behavior live — no retraining required.
- Learn from Human Experts — Publish expert-provided ideal responses alongside agent responses — Reflexio automatically extracts actionable playbook entries from the differences.
- Personal & Global Improvements — Separates individual user preferences from system-wide agent improvements.
- AI First Self-Optimization — Agents autonomously reflect, learn, and improve — less human-in-the-loop, more compounding gains.
How It Works

Publish conversations from your agent, and Reflexio closes the self-improvement loop. Interactions flow through the pipeline to produce User Profiles (per-user preferences), Playbooks (actionable improvement signals), and Evaluation Results (success/failure assessments). Everything is organized via Requests and Sessions.
Self-Hosted (Open-Source) vs Managed Enterprise
| Feature | Self-Hosted (Open-Source) | Managed Enterprise |
|---|---|---|
| Core engine (profiles, playbooks, evaluation) | Yes | Yes |
| Python client library | Yes | Yes |
| Local, SQLite, and Supabase storage | Yes | Yes |
| Multi-provider LLM support (via LiteLLM) | Yes | Yes |
| Semantic search (vector + full-text) | Yes | Yes |
| LangChain integration | Yes | Yes |
reflexio CLI for managing data and services | Yes | Yes |
Hosted API at https://www.reflexio.ai | - | Yes |
| Web portal & dashboard | - | Yes |
| Multi-tenant organization management | - | Yes |
| User authentication & API token management | - | Yes |
| Configuration encryption | - | Yes |
| Email notifications & verification | - | Yes |
| Zero-ops — no server to run yourself | - | Yes |
Enterprise
Pages and sections requiring Reflexio Enterprise are marked with this callout.