Metadata-Version: 2.4
Name: automagik-omni
Version: 0.2.0
Summary: Automagik Omni: Multi-tenant omnichannel messaging hub
Author-email: Felipe Rosa <felipe@namastex.ai>, Cezar Vasconcelos <cezar@namastex.ai>
Requires-Python: >=3.12
Description-Content-Type: text/markdown
Requires-Dist: pydantic>=2.10.6
Requires-Dist: pika>=1.3.2
Requires-Dist: python-dotenv>=1.0.1
Requires-Dist: requests>=2.32.3
Requires-Dist: sqlalchemy>=2.0.38
Requires-Dist: psycopg2-binary>=2.9.10
Requires-Dist: boto3>=1.34.0
Requires-Dist: httpx>=0.28.0
Requires-Dist: fastapi>=0.104.0
Requires-Dist: uvicorn>=0.23.2
Requires-Dist: alembic>=1.16.2
Requires-Dist: typer>=0.16.0
Requires-Dist: rich>=14.0.0
Requires-Dist: pytest>=8.0.0
Requires-Dist: pytest-asyncio>=0.21.0
Requires-Dist: pytest-cov>=4.0.0
Requires-Dist: pytz>=2025.2

# Automagik Omni

Multi-tenant omnichannel messaging hub with AI agent integration.

## Overview

This project implements an AI agent system that can integrate with various communication channels, starting with WhatsApp.

## Setup

1. Create a virtual environment: `python -m venv .venv`
2. Activate the virtual environment: `source .venv/bin/activate`
3. Install dependencies: `uv pip install -e .`

## Configuration

Copy the `.env.example` file (if available) to `.env` and fill in the required configuration values.

## Running the Application

```bash
automagik-omni start
```

Or using the legacy command:
```bash
omnihub start
```

Or using the legacy method:
```bash
python -m src.main
```

## CLI Commands

```bash
# Main commands
automagik-omni start              # Start the API server
automagik-omni status             # Show system status
automagik-omni health             # Health check

# Instance management
automagik-omni instance list      # List all instances
automagik-omni instance add       # Add new instance
automagik-omni instance show      # Show instance details

# Telemetry management
automagik-omni telemetry enable   # Enable usage analytics
automagik-omni telemetry disable  # Disable usage analytics
```

## Telemetry

Automagik Omni collects anonymous usage analytics to help improve the product. This includes:
- CLI command usage patterns
- API endpoint performance metrics
- System information (OS, Python version)

**No personal data, message content, or credentials are collected.**

To disable telemetry:
```bash
automagik-omni telemetry disable
```

Or set environment variable:
```bash
export AUTOMAGIK_OMNI_DISABLE_TELEMETRY=true
```

## Development

This project uses `uv` as the package manager. To add new dependencies:

```bash
uv add <package-name>
```

## Project Structure

- `src/` - Main source code directory
  - `agent/` - Agent implementation
  - `channels/` - Communication channel integrations
  - `db/` - Database models and repositories
- `tests/` - Test directory (to be implemented) 
