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.1.tar.gz (49.8 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.1-py3-none-any.whl (66.3 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: matraca-0.4.1.tar.gz
  • Upload date:
  • Size: 49.8 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.1.tar.gz
Algorithm Hash digest
SHA256 a13f99b799d5ff5a5a0f27efc8c6d6eb0ef0fffc522cd800d2f9ecd295013492
MD5 24c5105f1a48183ecf25b6c7f2a7cda0
BLAKE2b-256 6c428cbf272d174b75b57705c74a86a91ddcd4aeb586ebc9819ed5405df84fc5

See more details on using hashes here.

File details

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

File metadata

  • Download URL: matraca-0.4.1-py3-none-any.whl
  • Upload date:
  • Size: 66.3 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.1-py3-none-any.whl
Algorithm Hash digest
SHA256 258ccb2c4e6b5fe2411f4d5aaf3a586cf74eeda3e0059f346b0f79bf06ce06fa
MD5 1770bafc2313f842a8343a4bdd075572
BLAKE2b-256 606d626345320487c03e50deafee73b6d97d428f92bd24d69f8e540a3606c1c0

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