Skip to main content

Agente de IA pessoal para Telegram e WhatsApp, com suporte a múltiplos provedores de modelos e sistema de habilidades extensível.

Project description

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.

Instalação

uv tool install matraca

Node.js instalado no sistema é necessário para o canal WhatsApp.

Uso

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. Instale-as em ~/.matraca/skills/.

Ao criar sua skill contendo scripts Python, use a declaração de dependências da PEP 723. O agente executará o seu script de forma isolada em um ambiente gerenciado pelo uv.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

matraca-0.4.2.tar.gz (50.0 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

matraca-0.4.2-py3-none-any.whl (66.9 kB view details)

Uploaded Python 3

File details

Details for the file matraca-0.4.2.tar.gz.

File metadata

  • Download URL: matraca-0.4.2.tar.gz
  • Upload date:
  • Size: 50.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.10.10 {"installer":{"name":"uv","version":"0.10.10","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

File hashes

Hashes for matraca-0.4.2.tar.gz
Algorithm Hash digest
SHA256 e7ed90477331e21bcb3d64644da6d63e41cd13e41073a0b4531da5f7b2dcf119
MD5 4936847c5935423312ccb7e7b985e2e7
BLAKE2b-256 5fd835f7507c10eb6bbcc29784e77a228de158574aa8e1b67fe9523eb274a899

See more details on using hashes here.

File details

Details for the file matraca-0.4.2-py3-none-any.whl.

File metadata

  • Download URL: matraca-0.4.2-py3-none-any.whl
  • Upload date:
  • Size: 66.9 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.10.10 {"installer":{"name":"uv","version":"0.10.10","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

File hashes

Hashes for matraca-0.4.2-py3-none-any.whl
Algorithm Hash digest
SHA256 c74c6349d3e78a06598d97d0bfba4fce738bfd9f820f6b43007a6cbbe4045e3e
MD5 987e179a64b4cbe4a166b614b7fb936d
BLAKE2b-256 42c12de565ec2f2943dd55027a08b9da1777b2c870bccf08199c773e1e987fe7

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page