Spaces:
Sleeping
Sleeping
File size: 4,418 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 105 106 107 108 109 110 111 112 113 114 115 116 | # ACE Framework Examples
Navigation guide for all ACE examples. Each directory has its own detailed README.
## 🎯 Getting Started
**New to ACE?** Start with these:
- **[simple_ace_example.py](simple_ace_example.py)** - Minimal ACE usage (5 minutes)
- **[seahorse_emoji_ace.py](seahorse_emoji_ace.py)** - Self-reflection demo
- **[Quick Start Guide](../docs/getting-started/quick-start.md)** - Step-by-step tutorial
## 🧩 Integrations
Add ACE learning to existing systems:
### Browser Automation (browser-use)
**[browser-use/](browser-use/)** - Self-improving browser agents
- [simple_ace_agent.py](browser-use/simple_ace_agent.py) - Basic ACEAgent usage
- [domain-checker/](browser-use/domain-checker/) - Domain availability automation
- [form-filler/](browser-use/form-filler/) - Form filling automation
- [online-shopping/](browser-use/online-shopping/) - E-commerce automation
📖 See [browser-use/README.md](browser-use/README.md) for full guide
### LangChain Integration
**[langchain/](langchain/)** - Wrap LangChain chains/agents with learning
- [simple_chain_example.py](langchain/simple_chain_example.py) - Basic chain + ACE
- [agent_with_tools_example.py](langchain/agent_with_tools_example.py) - Agent with tools
📖 See [langchain/README.md](langchain/README.md) for patterns
### Custom Integration
**[custom_integration_example.py](custom_integration_example.py)** - Pattern for any agent
Shows the three-step integration: Inject → Execute → Learn
### Pipeline Composition
**[pipeline_composition/](pipeline_composition/)** - Build custom ACE pipelines
- [compose_custom_pipeline.py](pipeline_composition/compose_custom_pipeline.py) - Mix and match steps, add custom steps, use `build_steps()`
## 📊 Advanced Topics
### Production Learning
**[helicone/](helicone/)** - Learn from Helicone observability logs
- Parse production LLM traces
- Replay-based learning (cost-effective)
- Tool selection analysis
📖 See [helicone/README.md](helicone/README.md)
### Prompt Engineering
**[prompts/](prompts/)** - Compare ACE prompt versions
- [compare_v1_v2_prompts.py](prompts/compare_v1_v2_prompts.py) - v1.0 vs v2.0
- [advanced_prompts_v2.py](prompts/advanced_prompts_v2.py) - Advanced techniques
### Skillbook Management
- **[skillbook_persistence.py](skillbook_persistence.py)** - Save and load learned strategies
## 🗂️ Examples by Use Case
| Use Case | Example |
|----------|---------|
| Q&A systems | [simple_ace_example.py](simple_ace_example.py) |
| Browser automation | [browser-use/](browser-use/) |
| LangChain workflows | [langchain/](langchain/) |
| Custom agents | [custom_integration_example.py](custom_integration_example.py) |
| Custom pipelines | [pipeline_composition/](pipeline_composition/) |
| Production learning | [helicone/](helicone/) |
| Prompt optimization | [prompts/](prompts/) |
## 🚀 Quick Start
```bash
# 1. Install
pip install ace-framework
# 2. Set API key
export OPENAI_API_KEY="your-api-key"
# 3. Run example
python examples/simple_ace_example.py
# Browser examples (contributors: uv sync --group demos)
uv run python examples/browser-use/simple_ace_agent.py
```
## 📚 Documentation
> **Note:** Documentation has been reorganized. Previous top-level docs (`QUICK_START.md`, `INTEGRATION_GUIDE.md`, etc.) have moved to `docs/getting-started/`, `docs/guides/`, and `docs/api/`. Old versions are archived in `docs/old_docs/`.
- **[Quick Start Guide](../docs/getting-started/quick-start.md)** - 5-minute tutorial
- **[Integration Guide](../docs/guides/integration.md)** - Add ACE to existing agents
- **[API Reference](../docs/api/index.md)** - Complete API
- **[Complete ACE Guide](../docs/guides/complete-guide.md)** - Deep dive
## 🔧 Adapting Examples
Each example is documented for easy adaptation:
1. **Browser automation**: Copy [browser-use/TEMPLATE.py](browser-use/TEMPLATE.py)
2. **LangChain**: See [langchain/README.md](langchain/README.md) patterns
3. **Custom agent**: Follow [custom_integration_example.py](custom_integration_example.py)
4. **Other**: Check subdirectory READMEs for guidance
## ❓ Need Help?
- [GitHub Issues](https://github.com/kayba-ai/agentic-context-engine/issues)
- [Discord Community](https://discord.gg/mqCqH7sTyK)
- Check subdirectory READMEs for specific guidance
|