Spaces:
Sleeping
Sleeping
File size: 2,997 Bytes
116524e | 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 | # ACE Framework
**Agentic Context Engineering** — a framework for self-improving language model agents.
ACE enables AI agents to learn from their own execution feedback through three collaborative roles: **Agent**, **Reflector**, and **SkillManager**. Learned strategies accumulate in a **Skillbook** that makes every subsequent call smarter.
## The Learning Loop
```mermaid
graph LR
S[Sample] --> A[Agent]
A --> E[Environment]
E -->|feedback| R[Reflector]
R -->|analyzes| SM[SkillManager]
SM -->|updates| SK[Skillbook]
SK -.->|context| A
```
Each pass through the loop discovers new strategies, reinforces what works, and prunes what doesn't.
## Get Started in 30 Seconds
```python
from ace import ACELiteLLM
agent = ACELiteLLM.from_model("gpt-4o-mini")
answer = agent.ask("If all cats are animals, is Felix (a cat) an animal?")
agent.save("learned.json")
```
## Install
```bash
uv add ace-framework
```
## Quick Links
<div class="grid cards" markdown>
- **Getting Started**
---
Install the framework and run your first self-improving agent.
[:octicons-arrow-right-24: Installation](getting-started/installation.md)
[:octicons-arrow-right-24: Quick Start](getting-started/quick-start.md)
- **Concepts**
---
Understand the Skillbook, Roles, Insight Levels, and Update Operations.
[:octicons-arrow-right-24: Overview](concepts/overview.md)
- **Guides**
---
Build full pipelines, integrate with existing agents, tune prompts.
[:octicons-arrow-right-24: Full Pipeline](guides/full-pipeline.md)
[:octicons-arrow-right-24: Integration Guide](guides/integration.md)
- **Integrations**
---
Ready-made runners for LiteLLM, LangChain, browser-use, and Claude Code.
[:octicons-arrow-right-24: Integrations Overview](integrations/index.md)
- **Pipeline Composition**
---
Compose custom pipelines by mixing and matching steps for full control.
[:octicons-arrow-right-24: Composing Pipelines](guides/composing-pipelines.md)
[:octicons-arrow-right-24: Pipeline Engine](pipeline/index.md)
</div>
## Available Runners
| Runner | Framework | Use Case |
|--------|-----------|----------|
| [`ACELiteLLM`](integrations/litellm.md) | LiteLLM (100+ providers) | Simple self-improving agent |
| [`LangChain`](integrations/langchain.md) | LangChain Runnables | Wrap chains/agents with learning |
| [`BrowserUse`](integrations/browser-use.md) | browser-use | Browser automation with learning |
| [`ClaudeCode`](integrations/claude-code.md) | Claude Code CLI | Coding tasks with learning |
| [`ACE`](guides/full-pipeline.md) | Full pipeline | Agent + Reflector + SkillManager |
## Paper
This framework implements the method from:
> *Agentic Context Engineering: Evolving Contexts for Self-Improving Language Models*
> [arXiv:2510.04618](https://arxiv.org/abs/2510.04618)
|