Metadata-Version: 2.3
Name: matraca
Version: 0.4.2
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: Programming Language :: Python :: 3.13
Classifier: Intended Audience :: End Users/Desktop
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Topic :: Communications :: Chat
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: python-telegram-bot>=22.6
Requires-Dist: websockets>=15.0.1
Requires-Dist: html-to-markdown>=2.27.1
Requires-Dist: kreuzberg>=4.0
Requires-Dist: pydantic-ai-backend[console]>=0.1.13
Requires-Dist: summarization-pydantic-ai>=0.0.4
Requires-Dist: watchfiles>=1.0
Requires-Dist: pydantic-ai-skills>=0.5.1
Requires-Dist: jinja2>=3.1.6
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. Ele lida com arquivos, executa comandos no shell, extrai texto de páginas da web e possui um sistema de habilidades extensível compatível com [Agent Skills](https://agentskills.io/).

## Instalação

```bash
uv tool install matraca
```
[Node.js](https://nodejs.org/) instalado no sistema é necessário para o canal WhatsApp.

## 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 seu provedor de inteligência artificial, o nome que identifica o modelo e o token do bot (se Telegram).

## Contatos

Para garantir sua privacidade, o agente apenas responde a contatos previamente autorizados. O processo de autorização funciona da seguinte forma:

1. O usuário deve enviar uma primeira mensagem para o bot (pelo Telegram ou WhatsApp).
2. O bot registrará o contato no arquivo `~/.matraca/contacts.json`.
3. Abra o arquivo `~/.matraca/contacts.json` e altere `authorized` para `true`.

## Habilidades

Habilidades são extensões para o agente e seguem o padrão de [Agent Skills](https://agentskills.io/). Instale-as em `~/.matraca/skills/`.

Ao criar sua skill contendo scripts Python, use a declaração de dependências da [PEP 723](https://peps.python.org/pep-0723/). O agente executará o seu script de forma isolada em um ambiente gerenciado pelo [uv](https://docs.astral.sh/uv/).