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.0.tar.gz (49.5 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.0-py3-none-any.whl (66.0 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: matraca-0.4.0.tar.gz
  • Upload date:
  • Size: 49.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.10.9 {"installer":{"name":"uv","version":"0.10.9","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.0.tar.gz
Algorithm Hash digest
SHA256 010f68091c66a69a4df80401a74dcfd3db2bae825ce3cf89902122f6901a00a6
MD5 8653d70f739cbabc49bf49a9406a898f
BLAKE2b-256 4a27a74c65d648c1a0bf716f080c373ea10c3a7e8bf4eb6be2f4bdc6f3f996a5

See more details on using hashes here.

File details

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

File metadata

  • Download URL: matraca-0.4.0-py3-none-any.whl
  • Upload date:
  • Size: 66.0 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.10.9 {"installer":{"name":"uv","version":"0.10.9","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.0-py3-none-any.whl
Algorithm Hash digest
SHA256 9d9c5d78b97fcc9899e0419eb3995e621072cc1313f416f1c047d9729316dacb
MD5 c63622e6b69e3d8d877686f6a5fb3e3a
BLAKE2b-256 95c5ea6d94961ff7f4e9ba9742bd2987b2165919aaf8d0201d1e53d0cc25567c

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