Metadata-Version: 2.4
Name: agentix-agent-sdk
Version: 0.1.0
Summary: LLM-neutral Python agent framework with built-in multi-channel messaging and document automation.
Project-URL: Homepage, https://github.com/aftws-in/agentix-agent-sdk
Project-URL: Repository, https://github.com/aftws-in/agentix-agent-sdk
Project-URL: Documentation, https://docs.agentix.aftws.com
Project-URL: Issues, https://github.com/aftws-in/agentix-agent-sdk/issues
Project-URL: Changelog, https://github.com/aftws-in/agentix-agent-sdk/releases
Author: prameet savla
License-Expression: MIT
License-File: LICENSE
Keywords: agent-framework,ai-agents,anthropic-claude,automation,document-processing,enterprise-ai,llm-framework,llm-orchestration,multi-agent,openai-compatible,python-framework,slack-integration,tool-use,webhooks,whatsapp-integration
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Typing :: Typed
Requires-Python: >=3.11
Requires-Dist: anthropic<1.0,>=0.40
Requires-Dist: beautifulsoup4>=4.12
Requires-Dist: defusedxml==0.7.1
Requires-Dist: google-genai<2.0,>=1.0
Requires-Dist: httpx>=0.25
Requires-Dist: jsonschema>=4.0
Requires-Dist: lxml==5.3.0
Requires-Dist: mcp<2.0,>=1.0
Requires-Dist: openai<2.0,>=1.30
Requires-Dist: openpyxl==3.1.5
Requires-Dist: pandas==2.2.3
Requires-Dist: pdf2image==1.17.0
Requires-Dist: pdfplumber==0.11.4
Requires-Dist: pillow==10.4.0
Requires-Dist: pydantic>=2.0
Requires-Dist: pypdf==4.3.1
Requires-Dist: pytesseract>=0.3.10
Requires-Dist: python-docx==1.1.2
Requires-Dist: python-dotenv>=1.0
Requires-Dist: python-pptx==1.0.2
Requires-Dist: pyyaml>=6.0
Requires-Dist: reportlab==4.2.5
Requires-Dist: requests>=2.28
Requires-Dist: tavily-python>=0.3
Requires-Dist: tiktoken>=0.5
Requires-Dist: xlsxwriter==3.2.0
Provides-Extra: all
Requires-Dist: aiohttp>=3.9; extra == 'all'
Requires-Dist: aiosmtplib>=3.0; extra == 'all'
Requires-Dist: fakeredis>=2.0.0; extra == 'all'
Requires-Dist: mypy>=1.5; extra == 'all'
Requires-Dist: pytest-asyncio>=0.21; extra == 'all'
Requires-Dist: pytest>=7.0; extra == 'all'
Requires-Dist: python-dotenv>=1.0; extra == 'all'
Requires-Dist: pywin32>=306; (sys_platform == 'win32') and extra == 'all'
Requires-Dist: qrcode>=8.2; extra == 'all'
Requires-Dist: ruff>=0.1; extra == 'all'
Requires-Dist: slack-sdk>=3.27; extra == 'all'
Requires-Dist: types-pyyaml>=6.0; extra == 'all'
Provides-Extra: dev
Requires-Dist: aiohttp>=3.9; extra == 'dev'
Requires-Dist: fakeredis>=2.0.0; extra == 'dev'
Requires-Dist: mypy>=1.5; extra == 'dev'
Requires-Dist: pytest-asyncio>=0.21; extra == 'dev'
Requires-Dist: pytest>=7.0; extra == 'dev'
Requires-Dist: python-dotenv>=1.0; extra == 'dev'
Requires-Dist: ruff>=0.1; extra == 'dev'
Requires-Dist: types-pyyaml>=6.0; extra == 'dev'
Provides-Extra: gateway
Requires-Dist: aiohttp>=3.9; extra == 'gateway'
Requires-Dist: aiosmtplib>=3.0; extra == 'gateway'
Requires-Dist: python-dotenv>=1.0; extra == 'gateway'
Requires-Dist: pywin32>=306; (sys_platform == 'win32') and extra == 'gateway'
Requires-Dist: qrcode>=8.2; extra == 'gateway'
Requires-Dist: slack-sdk>=3.27; extra == 'gateway'
Description-Content-Type: text/markdown



# Agentix

Build production-ready AI agents with any LLM provider — OpenAI, Claude, Gemini, DeepSeek, or your own endpoint.

Agentix is a modular, pure-Python framework designed to scale from solo developer projects to enterprise-grade deployments, with built-in tools, multi-channel integrations, and advanced reasoning control.

---

## 🚀 Key Features

* 🧠 **LLM-neutral**
  Works with OpenAI, Anthropic (Claude), Google Gemini, DeepSeek, Ollama, vLLM, LiteLLM

* 🔁 **True Agent Loop**
  `input → LLM → tools → LLM → result`

* 🛠 **Built-in Tools**
  Filesystem, shell, web search, task management, sub-agents

* 📄 **Document Skills (out of the box)**
  PDF, Word, Excel, PowerPoint

* 🌐 **Multi-channel Gateway**
  Slack, WhatsApp, Email, Webhooks

* 🧩 **Extensible Architecture**
  Skills, plugins, MCP servers, multi-agent orchestration

* ⚙️ **Production Ready**
  Logging, sandboxing, hooks, structured output, streaming

---

## 📦 Installation

```bash
pip install agentix-agent-sdk
```

Optional extras:

```bash
pip install agentix-agent-sdk[gateway]   # Slack / WhatsApp / Email
pip install agentix-agent-sdk[all]       # Full install
```

---

## ⚡ Quickstart

### Simple query

```python
import asyncio
from agentix import AgentixAgentOptions, query, ResultMessage

async def main():
    options = AgentixAgentOptions(
        name="assistant",
        provider="openai",
        model="gpt-4o",
        system_prompt="You are a helpful assistant."
    )

    async for msg in query("What is 2 + 2?", options=options):
        if isinstance(msg, ResultMessage):
            print(msg.result)

asyncio.run(main())
```

---

### Multi-turn agent

```python
import asyncio
from agentix import AgentixAgentOptions, AgentixClient, ResultMessage

async def main():
    options = AgentixAgentOptions(
        name="assistant",
        provider="anthropic",
        model="claude-sonnet-4",
    )

    async with AgentixClient(options) as client:
        async for msg in client.query("Explain Python generators"):
            if isinstance(msg, ResultMessage):
                print(msg.result)

asyncio.run(main())
```

---

## 🧠 Core Concepts

### Agent Loop

Agentix follows a **Claude-style reasoning loop**:

```
User → LLM → Tool Use → LLM → ... → Final Answer
```

---

## 🛠 Built-in Capabilities

### Tools

* Filesystem: Read, Write, Edit, Search
* Shell: Bash execution
* Web: Search & fetch
* Utility: Task tracking, user input
* Agents: Delegate to sub-agents

### Skills

* `pdf` — extraction, OCR, merge
* `docx` — Word automation
* `pptx` — presentation generation
* `xlsx` — Excel workflows

> Some document features require **LibreOffice (`soffice`) in PATH**

---

## 🤖 Multi-Agent Support

```python
from agentix import AgentDefinition

options = AgentixAgentOptions(
    agents={
        "researcher": AgentDefinition(
            description="Search and summarize",
            tools=["WebSearch"]
        )
    }
)
```

---

## 🔌 MCP Support

Connect external tool ecosystems via Model Context Protocol:

```python
options = AgentixAgentOptions(
    mcp_servers={
        "filesystem": {
            "type": "stdio",
            "command": "npx",
            "args": ["@modelcontextprotocol/server-filesystem"]
        }
    }
)
```

---

## 🌐 Gateway (Optional)

Run agents across:

* Slack
* WhatsApp
* Email
* Webhooks

```bash
agentix-gateway
```

---

## ⚙️ Configuration

Project-based configuration:

```
.agentix/
├── settings.json
├── agents/
├── skills/
├── hooks/
```

---

## 🔐 Security & Sandbox

* Filesystem isolation
* Controlled tool execution
* Plugin verification

---

## 📊 Observability

* Structured logging (JSON)
* Tool-level tracing
* Streaming support

---

## 🔑 Environment Variables

```
AGENTIX_PROVIDER=openai
AGENTIX_MODEL=gpt-4o
AGENTIX_API_KEY=your-key
```

---

## 📚 Documentation

[https://docs.agentix.aftws.com/](https://docs.agentix.aftws.com/)

---

## 🤝 Contributing

Contributions welcome — please include tests and documentation.

---

## 📄 License

MIT

---

## 🔗 Links

* GitHub: [https://github.com/aftws-in/agentix-agent-sdk](https://github.com/aftws-in/agentix-agent-sdk)
* Issues: [https://github.com/aftws-in/agentix-agent-sdk/issues](https://github.com/aftws-in/agentix-agent-sdk/issues)

---
