Metadata-Version: 2.4
Name: augagent
Version: 1.1.0
Summary: An enterprise-grade autonomous ReAct agent framework
Home-page: https://github.com/augmencord/augagent
Author: Augmencord Research
Author-email: Augmencord <augmencord@gmail.com>
License: MIT
Project-URL: Homepage, https://github.com/Augmencord/augagent
Project-URL: Repository, https://github.com/Augmencord/augagent.git
Project-URL: Changelog, https://github.com/Augmencord/augagent/blob/main/CHANGELOG.md
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: pydantic>=2.0.0
Requires-Dist: httpx>=0.24.0
Provides-Extra: memory
Requires-Dist: chromadb>=0.4.0; extra == "memory"
Provides-Extra: web
Requires-Dist: markdownify>=0.11.0; extra == "web"
Requires-Dist: beautifulsoup4>=4.12.0; extra == "web"
Requires-Dist: requests>=2.31.0; extra == "web"
Provides-Extra: telemetry
Requires-Dist: opentelemetry-api>=1.20.0; extra == "telemetry"
Requires-Dist: opentelemetry-sdk>=1.20.0; extra == "telemetry"
Provides-Extra: api
Requires-Dist: fastapi>=0.100.0; extra == "api"
Requires-Dist: uvicorn[standard]>=0.23.0; extra == "api"
Requires-Dist: typer>=0.9.0; extra == "api"
Requires-Dist: websockets>=11.0.3; extra == "api"
Provides-Extra: mcp
Requires-Dist: mcp>=0.1.0; extra == "mcp"
Provides-Extra: dev
Requires-Dist: pytest>=7.0; extra == "dev"
Requires-Dist: pytest-asyncio>=0.21.0; extra == "dev"
Dynamic: author
Dynamic: home-page
Dynamic: license-file
Dynamic: requires-python

# AugAgent 🤖

[![PyPI version](https://badge.fury.io/py/augagent.svg)](https://badge.fury.io/py/augagent)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/)

**AugAgent** is an enterprise-grade multi-agent orchestration framework designed for resilience, observability, and compliance.

## ✨ Features

- **Resilience**: Built-in multi-model fallback routing and retries across OpenAI, Ollama, and LiteLLM compatible APIs.
- **Persistence**: Pluggable state checkpointers (SQLite & ChromaDB) for durable agent memory.
- **Extensibility**: Native MCP (Model Context Protocol) client wrapper to inject dynamic tools.
- **Assurance**: OpenTelemetry logging and strict Pydantic token budgets.
- **Security**: Immutable JSONL audit logging with automatic PII redaction and FastAPI RBAC.

## 🚀 Quickstart

### Installation

```bash
pip install augagent[api,telemetry,mcp]
```

### Basic Usage

```python
import asyncio
from augagent.agent import AugAgent
from augagent.models import AgentConfig, LLMConfig

async def main():
    agent = AugAgent(
        config=AgentConfig(
            name="ResearchBot",
            role="Analyst",
            goal="Analyze technical data",
            llm_config=LLMConfig(model="gpt-4o")
        )
    )
    
    result = await agent.run("What are the benefits of MCP?")
    print(result.output)

if __name__ == "__main__":
    asyncio.run(main())
```

## 📖 Documentation
Please refer to the `docs/` directory for our complete API reference and architectural guides.

## 🤝 Contributing
See [CONTRIBUTING.md](CONTRIBUTING.md) for how to help out.

## 🔐 Security
See [SECURITY.md](SECURITY.md) for vulnerability reporting.

## 📄 License
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
