Our take
Maintaineda few commits in the last 90 days- Activity
- 30
- Community
- 52
- Issues
- 21
- Pull requests
- 44
ACE is a promising research-oriented context-adaptation framework with an active but currently low-volume maintenance signal, and its adoption should be validated against your own tasks and API setup.
Good fit if
- You want to experiment with evolving agent context from execution feedback instead of fine-tuning model weights.
- Your work can be expressed as task data plus custom processing and evaluation, or uses one of the included evaluation tasks.
- You can use Python 3.10 or later and are comfortable configuring an LLM provider API.
Look elsewhere if
- You need a mature release cadence: the project has had no release in the past year and only a few commits recently.
- You require visible recent issue resolution: no issues were closed in the recent measurement period, although a pull request was merged.
- You need a packaged production service rather than a framework for running adaptation and evaluation experiments.
All health signals
| Last commit | 2026-08-24 (2 months ago) |
|---|---|
| Commits, last 90 days | 1 |
| Releases, last 12 months | 0 |
| Contributors | 6 (top contributor: 42% of commits) |
| Issues closed, last 90 days | 0 |
| Pull requests merged, last 90 days | 1 |
| Project age | 11 months |
Checked on 2026-10-12 with the GitHub API.
Overview
ACE is a Python framework for adapting language-agent context over time. It turns execution feedback into a structured playbook of strategies, insights, and mistakes to avoid, addressing the loss of useful detail that can happen when context is repeatedly rewritten.
Its Generator, Reflector, and Curator roles produce experience, extract lessons, and apply incremental updates. Teams can use it for offline adaptation with training and validation data, online adaptation during evaluation, or evaluation with an existing playbook.
Key Features
- Generates task trajectories and uses feedback to identify effective strategies and recurring errors.
- Separates lesson extraction from playbook curation with dedicated Reflector and Curator roles.
- Applies localized playbook updates, with helpful and harmful counters, rather than replacing the full context.
- Provides offline, online, and evaluation-only run modes.
- Includes evaluation integrations for AppWorld, FiNER, and XBRL Formula tasks.
- Supports multiple LLM API providers, including OpenAI, Together, SambaNova, and Commonstack.
- Offers extension points for custom datasets, data processors, and task-specific evaluation.
Use Cases
- Agent developers can test whether accumulated experience improves performance on repeated tasks such as AppWorld interactions.
- Financial NLP teams can adapt a playbook for information extraction or structured financial reasoning without labeled supervision, as described by the project.
- Researchers comparing context-adaptation methods can run offline or online experiments and inspect intermediate playbooks and logs.
- Teams with a custom task can implement the documented data-processing and evaluation methods to evaluate ACE on their own data.
What you need
Detected in the repository
- Python >=3.10 (from pyproject.toml)
License in plain words
Apache-2.0permissive
- Commercial use: yes
- Modify and redistribute: yes
- You must keep: the license, the NOTICE file and a note of your changes
- Share your changes: no
- Includes an explicit patent grant from the contributors:
A summary, not legal advice: the LICENSE file is what applies.
Getting Started
git clone https://github.com/ace-agent/ace.git
cd ace
uv sync
cp .env.example .env
Configure the API key for your chosen provider in .env, then see the README for usage and run configuration.
Considerations
- The measured status is Maintained, but recent activity is limited to a few commits, with no release in the past year. Six contributors have participated, and contribution is not concentrated in one person.
- The repository reports no CI configuration or test suite in the measured facts. Teams adopting it should assess how they will validate changes and their own experiment results.
- Running the framework requires access to a supported LLM API provider and appropriate credentials. The README does not specify a GPU or database requirement.
- ACE is Apache-2.0 licensed. Review the license terms when redistributing or incorporating it into a product.
- The README lists extending ACE for tool calling as coming soon, so that capability is not documented as an available tutorial or feature.
Found this useful?
Share it with someone who would like ace.