Assistente IA

Um assistente de IA desktop multiplataforma, completamente acessível e desenvolvido com foco em inclusão desde o primeiro dia.

💡 Motivação

Este projeto começou como uma prova de conceito: será que é possível criar uma aplicação de IA verdadeiramente acessível para pessoas cegas? Não apenas "usável", mas otimizada para quem depende de leitores de tela?

A resposta é sim. E o projeto evoluiu muito além disso.

A Jornada

Concebido inicialmente para testar a viabilidade de um chat acessível compatível com qualquer provedor de IA, o Assistente rapidamente se tornou uma ferramenta de trabalho indispensável. O projeto cresceu organicamente, incorporando novas funcionalidades conforme surgiam necessidades reais no dia-a-dia.

Este não é um projeto feito "para" pessoas cegas. É feito "por" uma pessoa cega, para ela mesma. Cada recurso foi pensado a partir da pergunta: "Como isso me ajudaria hoje?"

Inspirações

A interface e interações foram inspiradas em ferramentas que funcionam bem com leitores de tela:

IDEs modernos: Visual Studio Code, Cursor - navegação por atalhos, busca rápida
Ferramentas de comunicação: Slack - organização em threads e canais
Terminais: Bash, PowerShell, CMD - comandos eficientes, navegação por histórico
Aplicações produtivas: Windows Explorer, Excel, Google Sheets - atalhos de teclado, navegação estruturada
Ferramentas Google: busca instantânea, sugestões contextuais

O resultado é uma aplicação que parece familiar para quem já usa essas ferramentas, mas otimizada para IA.

Um Experimento Pessoal

Este projeto também é um experimento sobre até onde uma pessoa cega consegue ir construindo software usando IA como assistente. Todo o desenvolvimento foi feito usando ferramentas como:

Cursor
GitHub Copilot
Antigravity
Claude Code (via MCP)
E outras ferramentas de IA

A meta era escrever o mínimo de código manualmente possível, delegando a construção para IAs enquanto focava em arquitetura, design de acessibilidade e experiência do usuário.

Para Quem É Este Projeto

Primariamente: Desenvolvedores e usuários técnicos cegos que precisam de uma ferramenta de IA eficiente.

Mas também: Qualquer pessoa que valorize acessibilidade. Recursos como questionários guiados e busca na web tornam a ferramenta útil mesmo para usuários menos técnicos com deficiência visual.

♿ Acessibilidade em Primeiro Lugar

Recursos de Acessibilidade

Navegação e Estrutura:

✅ Skip link para pular direto ao conteúdo principal
✅ Landmarks ARIA para navegação rápida entre seções
✅ Navegação completa por teclado - nenhuma funcionalidade requer mouse
✅ Focus visível e ordem lógica de tabulação
✅ Atalhos de teclado intuitivos:
- Alt + 1: Navegar para o Chat
- Alt + 2: Navegar para Configurações
- Enter: Enviar mensagem
- Shift + Enter: Nova linha na mensagem

Leitores de Tela:

✅ Live regions (anúncios ao vivo) para comunicar mudanças dinâmicas
✅ Modo Acessibilidade - desativa streaming e anuncia respostas completas
✅ Labels descritivos em todos os controles e botões
✅ Roles e estados ARIA corretamente implementados
✅ Anúncios contextuais para feedback de ações

Visual e Design:

✅ Alto contraste com suporte a preferências do sistema
✅ Áreas de toque mínimas de 44x44px (WCAG AAA)
✅ Textos redimensionáveis sem perda de funcionalidade
✅ Indicadores de estado claros e persistentes

Testado Com

NVDA (Windows)
Narrator (Windows)
JAWS (Windows)

✨ Recursos

🤖 Compatível com OpenAI API e serviços compatíveis
🔄 Auto-update - atualizações automáticas via GitHub Releases
🎯 Streaming opcional - pode ser desativado para melhor acessibilidade
🔌 Suporte a múltiplos provedores (OpenAI, Ollama, LM Studio, Azure, etc.)
💬 Integração com mensageiros - Telegram e Signal
🎭 Perfis de interação - personalize o comportamento do assistente
🛠️ Model Context Protocol (MCP) - use ferramentas externas
🌍 Multiplataforma - Windows, macOS e Linux

🚀 Como Funciona

Arquitetura

O Assistente é construído com:

Backend: Go (Golang) - alto desempenho e compilação nativa
Frontend: React + TypeScript - interface moderna e acessível
Desktop: Wails v2 - combina Go + WebView nativo do sistema
Auto-update: Sistema próprio via GitHub Releases API

O Que Você Precisa

Para Usar:

Sistema operacional: Windows 10+, macOS 10.13+, ou Linux com GTK3
Chave de API da OpenAI OU um servidor local (Ollama, LM Studio)
Conexão com internet (ou rede local para servidores locais)

Para Desenvolver:

Go 1.23+
Node.js 20+
Wails CLI
Windows: gcc (via MinGW) | macOS: Xcode tools | Linux: gcc + gtk3-dev

� Instalação

Usuários Finais

Baixe o instalador para seu sistema operacional na página de releases:

Windows: assistente-windows-amd64-installer.exe
macOS (Apple Silicon): assistente-darwin-arm64.dmg
macOS (Intel): assistente-darwin-amd64.dmg
Linux: assistente-linux-amd64.AppImage

Desenvolvedores

Instale o Wails CLI:

go install github.com/wailsapp/wails/v2/cmd/wails@latest

Clone e compile:

# Clone o repositório
git clone https://github.com/inclunet/assistente.git
cd assistente

# Instale dependências do frontend
cd frontend
npm install
cd ..

# Execute em modo desenvolvimento
wails dev

# Ou compile para produção
wails build

O executável será gerado em build/bin/.

⚙️ Configuração

Primeira Execução

Na primeira inicialização, você será guiado para configurar:

Chave de API - Sua API key do provedor escolhido (OpenAI, etc.)
URL Base - Endpoint da API (padrão: https://api.openai.com/v1)

As configurações são salvas em:

Windows: %USERPROFILE%\.assistente\config.json
macOS/Linux: ~/.assistente/config.json

Modo Acessibilidade

⚠️ Altamente recomendado para usuários de leitores de tela:

Acesse Configurações (Alt + 2)
Ative "Modo Acessibilidade"
Quando ativado:
- Streaming é desabilitado
- Respostas completas são anunciadas de uma vez
- Melhor experiência com NVDA/JAWS/Narrator

📖 Como Usar

Menu de Ajuda

Pressione F1 ou acesse o menu Ajuda para ver:

Lista completa de atalhos de teclado
Guia rápido de recursos
Dicas de acessibilidade
Documentação do MCP
Sobre a aplicação

Atalhos Essenciais

Atalho	Ação
`F1`	Abrir menu de ajuda
`Alt + 1`	Ir para Chat
`Alt + 2`	Ir para Configurações
`Ctrl + N`	Nova conversa
`Ctrl + K`	Busca rápida
`Ctrl + /`	Alternar barra lateral
`Enter`	Enviar mensagem
`Shift + Enter`	Nova linha
`Esc`	Cancelar/Fechar

Dicas de Uso

Para usuários de leitores de tela:

Ative o "Modo Acessibilidade" nas configurações
Use Tab para navegar entre elementos
Use F6 para alternar entre painéis principais
Respostas são anunciadas automaticamente quando completas

Para todos os usuários:

Digite / no chat para ver comandos rápidos
Use Ctrl + K para busca rápida em conversas
Organize conversas em tabs para melhor produtividade
Configure perfis diferentes para contextos diferentes (trabalho, pessoal, etc.)

Provedores Suportados

Basta configurar a URL Base da API para usar diferentes serviços:

Provedor	URL Base	Como Obter API Key
OpenAI (padrão)	`https://api.openai.com/v1`	platform.openai.com/api-keys - Requer cartão de crédito
Anthropic (Claude)	`https://api.anthropic.com/v1`	console.anthropic.com - Via OpenAI-compatible
Google AI	`https://generativelanguage.googleapis.com/v1`	makersuite.google.com/app/apikey - Plano gratuito generoso
Groq	`https://api.groq.com/openai/v1`	console.groq.com - Gratuito, muito rápido
OpenRouter	`https://openrouter.ai/api/v1`	openrouter.ai/keys - Acesso a 100+ modelos, pay-as-you-go
Ollama (Local)	`http://localhost:11434/v1`	Sem API key - ollama.ai - 100% gratuito, roda localmente
LM Studio (Local)	`http://localhost:1234/v1`	Sem API key - lmstudio.ai - 100% gratuito, roda localmente
Azure OpenAI	`https://SEU-RECURSO.openai.azure.com/...`	Via portal Azure - Requer assinatura Azure

💡 Dica para iniciantes: Comece com Groq (gratuito e rápido) ou Ollama (roda no seu PC, sem internet).

� Recursos Avançados

Model Context Protocol (MCP)

Permite que o assistente use ferramentas externas (filesystem, web search, databases, etc.):

Configure servidores MCP no arquivo de configuração
O assistente detecta e oferece as ferramentas disponíveis
Executa ações conforme necessário durante conversas

Veja MCP_COMPLETE_IMPLEMENTATION.md para detalhes.

Perfis de Interação

Personalize o comportamento do assistente:

Instruções do sistema customizadas
Temperatura e parâmetros ajustáveis por perfil
Modelos diferentes por perfil

Veja INTERACTION_PROFILES_ARCHITECTURE.md.

📡 Integração com Mensageiros

O assistente pode receber e responder mensagens via Telegram ou Signal.

Telegram

Crie um bot via @BotFather
Salve em ~/.assistente/telegram.json:

{
  "enabled": true,
  "bot_token": "SEU_TOKEN_DO_BOTFATHER",
  "max_history": 50,
  "max_contacts": 1
}

Signal

Configure signal-cli-rest-api
Salve em ~/.assistente/signal.json:

{
  "enabled": true,
  "api_url": "http://localhost:8080",
  "account": "+5511999999999",
  "max_history": 50,
  "max_contacts": 1
}

Dica: O app pode pedir autorização automática quando chega mensagem de novo contato.

�️ Desenvolvimento

Estrutura do Projeto

assistente/
├── main.go                    # Entry point
├── app.go                     # Aplicação principal Wails
├── agent.go                   # Agente conversacional
├── llm.go                     # Cliente LLM com streaming
├── db.go                      # Banco de dados SQLite
├── internal/
│   ├── updater/               # Sistema de auto-update
│   ├── mcp/                   # Model Context Protocol
│   ├── profiles/              # Perfis de interação
│   ├── speech/                # Text-to-speech
│   ├── channels/              # Telegram/Signal
│   └── ...
├── frontend/
│   ├── src/
│   │   ├── App.tsx           # Componente raiz
│   │   ├── components/       # Componentes UI
│   │   ├── pages/            # Páginas da aplicação
│   │   ├── services/         # Serviços (API, MCP)
│   │   └── utils/            # Utilitários acessibilidade
│   └── wailsjs/              # Bindings Go ↔ JS
└── docs/                      # Documentação

Comandos Úteis

# Desenvolvimento com hot-reload
wails dev

# Build para produção
wails build

# Regenerar bindings TypeScript
wails generate module

# Executar testes
go test ./...

# Build multiplataforma (via GitHub Actions)
git tag v1.0.0
git push --tags

Contribuindo

Contribuições são bem-vindas! Especialmente em:

🎯 Melhorias de acessibilidade
🌍 Traduções e internacionalização
🐛 Correção de bugs
📝 Documentação
✨ Novos recursos

Por favor, abra uma issue primeiro para discutir mudanças maiores.

📜 Licença

MIT License - veja LICENSE para detalhes.

🙏 Agradecimentos

Projeto inspirado pela necessidade de ferramentas mais inclusivas
Comunidade Wails pela excelente framework
Usuários que testaram e deram feedback sobre acessibilidade
Todos que contribuem para tornar a tecnologia mais acessível

Nota: Este é um projeto pessoal open source e não é afiliado a nenhuma empresa ou organização.

Name		Name	Last commit message	Last commit date
Latest commit History 150 Commits
.assistente/skills/memory		.assistente/skills/memory
.claude		.claude
.cursor/rules		.cursor/rules
.github/workflows		.github/workflows
build		build
docs		docs
frontend		frontend
internal		internal
node_modules		node_modules
.gitignore		.gitignore
README.md		README.md
agent.go		agent.go
app.go		app.go
db.go		db.go
export_import.go		export_import.go
go.mod		go.mod
go.sum		go.sum
llm.go		llm.go
llm_slash_test.go		llm_slash_test.go
main.go		main.go
package-lock.json		package-lock.json
package.json		package.json
wails.json		wails.json

inclunet/assistente

Folders and files

Latest commit

History

Repository files navigation