Metadata-Version: 2.3
Name: matraca
Version: 0.1.0
Summary: Agente de IA pessoal para Telegram e WhatsApp, com suporte a múltiplos provedores de modelos e sistema de habilidades extensível.
Keywords: ai,agent,telegram,whatsapp,chatbot,llm,pydantic-ai
License: MIT
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: End Users/Desktop
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Communications :: Chat
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Requires-Dist: uv
Requires-Dist: pydantic>=2.12.5
Requires-Dist: pydantic-ai-slim[google,anthropic,openai,groq,mistral,cohere,openrouter]>=1.63.0
Requires-Dist: pydantic-deep>=0.2.17
Requires-Dist: python-telegram-bot>=22.6
Requires-Dist: websockets>=15.0.1
Requires-Python: >=3.13, <3.14
Description-Content-Type: text/markdown

# Matraca

Agente de inteligência artificial para **Telegram** e **WhatsApp**. Roda no seu computador, você usa pelos apps dos canais.

Você pode usar com qualquer provedor e modelo suportado pelo PydanticAI. Tem memória persistente, pesquisa na web, acesso a arquivos e sistema de habilidades extensível via scripts Python.

## Instalação

Requer Python 3.13 e [uv](https://docs.astral.sh/uv/). [Node.js](https://nodejs.org/) é necessário para o canal WhatsApp.

```bash
uv tool install matraca
```

## Uso

```bash
matraca telegram   # inicia o canal Telegram
matraca whatsapp   # inicia o canal WhatsApp
```

Na primeira execução, o arquivo de configuração é criado em `~/.matraca/config.json`. Adicione as chaves do provedor escolhido e o token do bot (se Telegram) antes de iniciar.

## Habilidades

Habilidades são scripts Python que ampliam o agente. Instale-as em `~/.matraca/skills/` — cada uma é uma pasta com um `SKILL.md` e scripts em `scripts/`.

## Licença

MIT
