# Teraace Agentic Tracker
A comprehensive Python library for tracking AI agent events across 20 major agentic frameworks and sending them to the Teraace API for monitoring and analysis.
## 🚀 Features
- **20 Framework Support**: LangChain, CrewAI, AutoGPT, Swarm, LlamaIndex, AutoGen, Phidata, BabyAGI, MetaGPT, TaskWeaver, CAMEL, AgentGPT, SuperAGI, Semantic Kernel, Haystack, Rasa, PydanticAI, DSPy, Mirascope, Instructor
- **Unified Tracking**: Consistent event tracking across all frameworks
- **Production Ready**: Buffered delivery, async API client, graceful shutdown
- **Thread-Safe**: Safe for multi-threaded applications
- **Extensible**: Easy to add new framework integrations
## 📦 Teraace Account
Create your Teraace account at https://app.teraace.com/signup
## 📦 Installation
```bash
pip install teraace-tracker
```
## ⚡ Quick Start
### 1. Configuration
Create a `.env` file:
```env
TERAACE_API_KEY=your_api_key_here
TERAACE_BUFFER_SIZE=20
TERAACE_API_ENDPOINT=https://api.teraace.com/agents
TERAACE_REQUEST_TIMEOUT=30
TERAACE_MAX_RETRIES=3
```
### 2. Basic Usage
```python
from teraace_tracker import LangChainTracker
# Initialize tracker
tracker = LangChainTracker()
# Use with your LangChain agent
agent = initialize_agent(
tools=your_tools,
llm=llm,
callbacks=[tracker] # Add tracker as callback
)
# Use agent normally - events are tracked automatically
result = agent.run("What is 2 + 2?")
```
### 3. Other Frameworks
- **[AGENTS.md](AGENTS.md)** - Comprehensive examples for all 20 frameworks
```python
# CrewAI
from teraace_tracker import CrewAITracker
tracker = CrewAITracker()
tracker.track_crew_execution(crew)
# OpenAI Swarm
from teraace_tracker import SwarmTracker
tracker = SwarmTracker()
# LlamaIndex
from teraace_tracker import LlamaIndexTracker
tracker = LlamaIndexTracker()
# AutoGen
from teraace_tracker import AutoGenTracker
tracker = AutoGenTracker()
# And 11 more frameworks...
```
## 🎯 Supported Frameworks
| Framework | Status | Use Case |
|-----------|--------|----------|
| **LangChain** | ✅ | General-purpose agent framework |
| **CrewAI** | ✅ | Multi-agent collaboration |
| **AutoGPT** | ✅ | Autonomous task execution |
| **OpenAI Swarm** | ✅ | Multi-agent orchestration |
| **LlamaIndex** | ✅ | Data-centric agents & RAG |
| **AutoGen** | ✅ | Multi-agent conversations |
| **Phidata** | ✅ | Production AI assistants |
| **BabyAGI** | ✅ | Autonomous task prioritization |
| **MetaGPT** | ✅ | Software development teams |
| **TaskWeaver** | ✅ | Code-first stateful agents |
| **CAMEL** | ✅ | Communicative agent societies |
| **AgentGPT** | ✅ | Web-based autonomous agents |
| **SuperAGI** | ✅ | Open-source agent infrastructure |
| **Semantic Kernel** | ✅ | Microsoft AI orchestration |
| **Haystack** | ✅ | NLP/RAG with agents |
| **Rasa** | ✅ | Conversational AI |
| **PydanticAI** | ✅ | Production-grade AI applications |
| **DSPy** | ✅ | Prompt optimization framework |
| **Mirascope** | ✅ | Type-safe LLM toolkit |
| **Instructor** | ✅ | Structured data extraction |
## 📊 What Gets Tracked
- **Agent Lifecycle**: Creation, execution, completion
- **Tool Usage**: Function calls and results
- **Memory Operations**: Read, write, update operations
- **Multi-Agent Interactions**: Handoffs and collaboration
- **Code Generation**: Generated code and execution
- **Planning & Reasoning**: Agent thought processes
- **Resource Management**: File and data operations
## 🔧 Configuration
| Environment Variable | Default | Description |
|---------------------|---------|-------------|
| `TERAACE_API_KEY` | Required | Your Teraace API key |
| `TERAACE_BUFFER_SIZE` | 20 | Events to buffer before sending |
| `TERAACE_API_ENDPOINT` | `https://api.teraace.com/agent-events` | API endpoint |
## 📚 Documentation
- **[AGENTS.md](AGENTS.md)** - Comprehensive examples for all 20 frameworks
- **[API Reference](docs/api.md)** - Detailed API documentation
- **[Configuration Guide](docs/config.md)** - Advanced configuration options
## 🛠️ Development
```bash
git clone https://github.com/teraace/teraace-tracker
cd teraace-tracker
pip install -e .[dev]
pytest
```
## 🤝 Contributing
We welcome contributions! Please see our [Contributing Guide](CONTRIBUTING.md) for details.
## 📄 License
MIT License - see [LICENSE](LICENSE) file for details.
## 🆘 Support
- **Documentation**: [docs.teraace.com](https://docs.teraace.com)
- **Email**: support@teraace.com
- **Issues**: [GitHub Issues](https://github.com/teraace/teraace-tracker/issues)
Raw data
{
"_id": null,
"home_page": null,
"name": "teraace-tracker",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": "Teraace Team <dev@teraace.com>",
"keywords": "ai, agents, tracking, monitoring, observability, langchain, crewai, autogpt, llm, machine-learning, analytics, telemetry, agentic, autonomous",
"author": null,
"author_email": "Teraace <support@teraace.com>",
"download_url": "https://files.pythonhosted.org/packages/12/0b/a651174cc118a49e6108ee5b03108ab996e6afcd93f8f94bedd32c5cdf1f/teraace_tracker-1.1.8.tar.gz",
"platform": null,
"description": "# Teraace Agentic Tracker\n\nA comprehensive Python library for tracking AI agent events across 20 major agentic frameworks and sending them to the Teraace API for monitoring and analysis.\n\n## \ud83d\ude80 Features\n\n- **20 Framework Support**: LangChain, CrewAI, AutoGPT, Swarm, LlamaIndex, AutoGen, Phidata, BabyAGI, MetaGPT, TaskWeaver, CAMEL, AgentGPT, SuperAGI, Semantic Kernel, Haystack, Rasa, PydanticAI, DSPy, Mirascope, Instructor\n- **Unified Tracking**: Consistent event tracking across all frameworks\n- **Production Ready**: Buffered delivery, async API client, graceful shutdown\n- **Thread-Safe**: Safe for multi-threaded applications\n- **Extensible**: Easy to add new framework integrations\n\n## \ud83d\udce6 Teraace Account\n\nCreate your Teraace account at https://app.teraace.com/signup\n\n\n## \ud83d\udce6 Installation\n\n```bash\npip install teraace-tracker\n```\n\n## \u26a1 Quick Start\n\n### 1. Configuration\n\nCreate a `.env` file:\n\n```env\nTERAACE_API_KEY=your_api_key_here\nTERAACE_BUFFER_SIZE=20\nTERAACE_API_ENDPOINT=https://api.teraace.com/agents\nTERAACE_REQUEST_TIMEOUT=30\nTERAACE_MAX_RETRIES=3\n\n```\n\n### 2. Basic Usage\n\n```python\nfrom teraace_tracker import LangChainTracker\n\n# Initialize tracker\ntracker = LangChainTracker()\n\n# Use with your LangChain agent\nagent = initialize_agent(\n tools=your_tools,\n llm=llm,\n callbacks=[tracker] # Add tracker as callback\n)\n\n# Use agent normally - events are tracked automatically\nresult = agent.run(\"What is 2 + 2?\")\n```\n\n### 3. Other Frameworks\n- **[AGENTS.md](AGENTS.md)** - Comprehensive examples for all 20 frameworks\n\n```python\n# CrewAI\nfrom teraace_tracker import CrewAITracker\ntracker = CrewAITracker()\ntracker.track_crew_execution(crew)\n\n# OpenAI Swarm\nfrom teraace_tracker import SwarmTracker\ntracker = SwarmTracker()\n\n# LlamaIndex\nfrom teraace_tracker import LlamaIndexTracker\ntracker = LlamaIndexTracker()\n\n# AutoGen\nfrom teraace_tracker import AutoGenTracker\ntracker = AutoGenTracker()\n\n# And 11 more frameworks...\n```\n\n## \ud83c\udfaf Supported Frameworks\n\n| Framework | Status | Use Case |\n|-----------|--------|----------|\n| **LangChain** | \u2705 | General-purpose agent framework |\n| **CrewAI** | \u2705 | Multi-agent collaboration |\n| **AutoGPT** | \u2705 | Autonomous task execution |\n| **OpenAI Swarm** | \u2705 | Multi-agent orchestration |\n| **LlamaIndex** | \u2705 | Data-centric agents & RAG |\n| **AutoGen** | \u2705 | Multi-agent conversations |\n| **Phidata** | \u2705 | Production AI assistants |\n| **BabyAGI** | \u2705 | Autonomous task prioritization |\n| **MetaGPT** | \u2705 | Software development teams |\n| **TaskWeaver** | \u2705 | Code-first stateful agents |\n| **CAMEL** | \u2705 | Communicative agent societies |\n| **AgentGPT** | \u2705 | Web-based autonomous agents |\n| **SuperAGI** | \u2705 | Open-source agent infrastructure |\n| **Semantic Kernel** | \u2705 | Microsoft AI orchestration |\n| **Haystack** | \u2705 | NLP/RAG with agents |\n| **Rasa** | \u2705 | Conversational AI |\n| **PydanticAI** | \u2705 | Production-grade AI applications |\n| **DSPy** | \u2705 | Prompt optimization framework |\n| **Mirascope** | \u2705 | Type-safe LLM toolkit |\n| **Instructor** | \u2705 | Structured data extraction |\n\n## \ud83d\udcca What Gets Tracked\n\n- **Agent Lifecycle**: Creation, execution, completion\n- **Tool Usage**: Function calls and results\n- **Memory Operations**: Read, write, update operations\n- **Multi-Agent Interactions**: Handoffs and collaboration\n- **Code Generation**: Generated code and execution\n- **Planning & Reasoning**: Agent thought processes\n- **Resource Management**: File and data operations\n\n## \ud83d\udd27 Configuration\n\n| Environment Variable | Default | Description |\n|---------------------|---------|-------------|\n| `TERAACE_API_KEY` | Required | Your Teraace API key |\n| `TERAACE_BUFFER_SIZE` | 20 | Events to buffer before sending |\n| `TERAACE_API_ENDPOINT` | `https://api.teraace.com/agent-events` | API endpoint |\n\n## \ud83d\udcda Documentation\n\n- **[AGENTS.md](AGENTS.md)** - Comprehensive examples for all 20 frameworks\n- **[API Reference](docs/api.md)** - Detailed API documentation\n- **[Configuration Guide](docs/config.md)** - Advanced configuration options\n\n## \ud83d\udee0\ufe0f Development\n\n```bash\ngit clone https://github.com/teraace/teraace-tracker\ncd teraace-tracker\npip install -e .[dev]\npytest\n```\n\n## \ud83e\udd1d Contributing\n\nWe welcome contributions! Please see our [Contributing Guide](CONTRIBUTING.md) for details.\n\n## \ud83d\udcc4 License\n\nMIT License - see [LICENSE](LICENSE) file for details.\n\n## \ud83c\udd98 Support\n\n- **Documentation**: [docs.teraace.com](https://docs.teraace.com)\n- **Email**: support@teraace.com\n- **Issues**: [GitHub Issues](https://github.com/teraace/teraace-tracker/issues)\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "A comprehensive Python library for tracking AI agent events across LangChain, CrewAI, and AutoGPT frameworks",
"version": "1.1.8",
"project_urls": {
"Bug Tracker": "https://github.com/hyepartners-gmail/teraace-tracker/issues",
"Documentation": "https://docs.teraace.com",
"Homepage": "https://www.teraace.com",
"Repository": "https://github.com/hyepartners-gmail/teraace-tracker"
},
"split_keywords": [
"ai",
" agents",
" tracking",
" monitoring",
" observability",
" langchain",
" crewai",
" autogpt",
" llm",
" machine-learning",
" analytics",
" telemetry",
" agentic",
" autonomous"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "b002ddc27d09c9fa600eab6bdd211347fc937a3f636d99f9691c037fbf905ebf",
"md5": "e5e545bb8050140d4ed6d45bbca53658",
"sha256": "98ff5d986a4d04cfafddb79b083c605d707c0abf58bda7dde9b205908585efb8"
},
"downloads": -1,
"filename": "teraace_tracker-1.1.8-py3-none-any.whl",
"has_sig": false,
"md5_digest": "e5e545bb8050140d4ed6d45bbca53658",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 88629,
"upload_time": "2025-07-25T21:23:29",
"upload_time_iso_8601": "2025-07-25T21:23:29.116717Z",
"url": "https://files.pythonhosted.org/packages/b0/02/ddc27d09c9fa600eab6bdd211347fc937a3f636d99f9691c037fbf905ebf/teraace_tracker-1.1.8-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "120ba651174cc118a49e6108ee5b03108ab996e6afcd93f8f94bedd32c5cdf1f",
"md5": "3f88a5baec6c89b963b3870e824b4a1e",
"sha256": "3591211375ed3c3c816ccba5ceb673e0322540b81f11371f257ef2fecec32543"
},
"downloads": -1,
"filename": "teraace_tracker-1.1.8.tar.gz",
"has_sig": false,
"md5_digest": "3f88a5baec6c89b963b3870e824b4a1e",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 76754,
"upload_time": "2025-07-25T21:23:30",
"upload_time_iso_8601": "2025-07-25T21:23:30.552016Z",
"url": "https://files.pythonhosted.org/packages/12/0b/a651174cc118a49e6108ee5b03108ab996e6afcd93f8f94bedd32c5cdf1f/teraace_tracker-1.1.8.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-07-25 21:23:30",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "hyepartners-gmail",
"github_project": "teraace-tracker",
"github_not_found": true,
"lcname": "teraace-tracker"
}
JSON
