README
¶
Assistente de Codigo AI 100% Local
CLI para programacao com inteligencia artificial usando Ollama, sem internet ou assinaturas
Overview • Instalacao • Uso • Funcionalidades • Configuracao • Documentacao • Licenca
Overview
Ollama Code e um assistente de programacao com inteligencia artificial que roda 100% no seu computador. Funciona offline, e gratuito, open source e garante privacidade total do seu codigo.
O que voce obtem:
- Assistente de IA rodando localmente (privacidade total)
- Funcionamento offline para a maioria das operacoes
- Gratuito e open source, sem limites de uso
- Suporte a multiplas linguagens de programacao
- Pesquisa na internet integrada (opcional)
- Analise de codigo com sugestoes de melhorias
- Sistema de configuracao hierarquico (OLLAMA.md)
Instalacao
Requisitos
| Requisito | Versao | Descricao |
|---|---|---|
| Ollama | Ultima | Runtime para modelos de IA locais |
| Go | 1.21+ | Necessario apenas para compilar do codigo-fonte |
Passo 1: Instalar Ollama
Windows: Baixe em ollama.com/download/windows e execute o instalador.
Linux/Mac:
curl -fsSL https://ollama.com/install.sh | sh
Passo 2: Baixar um modelo de IA
| Modelo | RAM Necessaria | Perfil |
|---|---|---|
qwen2.5-coder:7b |
4GB | Rapido, ideal para comecar |
qwen2.5-coder:14b |
8GB | Balanceado (recomendado) |
qwen2.5-coder:32b |
16GB+ | Mais preciso, mais lento |
# Exemplo: baixar modelo recomendado
ollama pull qwen2.5-coder:14b
Passo 3: Instalar Ollama Code
Opcao A: Baixar executavel
- Acesse Releases
- Baixe para seu sistema operacional
- Coloque em uma pasta no PATH
Opcao B: Compilar do codigo-fonte
git clone https://github.com/JohnPitter/ollama-code.git
cd ollama-code
chmod +x build.sh
./build.sh
./build/ollama-code --version
Uso
Ollama Code oferece 3 modos de uso:
Perguntas Rapidas (ask)
ollama-code ask "Como ler um arquivo JSON em Go?"
ollama-code ask "Qual a diferenca entre let e var em JavaScript?"
ollama-code ask "Pesquise na internet sobre Go 1.23"
Chat Interativo (chat)
ollama-code chat
Dentro do chat, faca perguntas livremente. Digite exit para sair.
Modo Autonomo (autonomous)
O assistente pode modificar arquivos automaticamente:
ollama-code chat --mode autonomous
Atencao: Neste modo, o assistente pode modificar seus arquivos sem confirmacao.
Funcionalidades
| Funcionalidade | Descricao |
|---|---|
| Pesquisa na Internet | Busca no DuckDuckGo, extrai conteudo e resume informacoes |
| Skill: Research | Pesquisa web, compara tecnologias, encontra documentacao |
| Skill: API | Testa endpoints, analisa APIs REST, faz requisicoes HTTP |
| Skill: Code Analysis | Detecta bugs, mede complexidade, sugere otimizacoes |
| Sistema OLLAMA.md | Configuracao hierarquica em 4 niveis (Enterprise, Project, Language, Local) |
| Modo Readonly | Analisa sem alterar nenhum arquivo |
| Modo Interativo | Pergunta antes de modificar (padrao) |
| Modo Autonomo | Modifica arquivos automaticamente |
Comparacao com Alternativas
| Recurso | Ollama Code | ChatGPT/Claude | GitHub Copilot |
|---|---|---|---|
| Privacidade | 100% Local | Envia dados | Envia dados |
| Custo | Gratis | $20/mes | $10/mes |
| Offline | Funciona | Precisa internet | Precisa internet |
| Sem limite | Ilimitado | Limitado | Limitado |
| Codigo proprietario | Fica no seu PC | Vai para servidores | Vai para servidores |
Configuracao
Mudar o modelo de IA
ollama-code chat --model qwen2.5-coder:32b
ollama-code chat --model qwen2.5-coder:7b
Modos de operacao
| Modo | Comando | Descricao |
|---|---|---|
| Readonly | --mode readonly |
Nao altera nada |
| Interativo | --mode interactive |
Pergunta antes de modificar (padrao) |
| Autonomo | --mode autonomous |
Modifica sem perguntar |
Arquivo de configuracao
Crie ~/.ollama-code/config.json:
{
"ollama_url": "http://localhost:11434",
"model": "qwen2.5-coder:7b",
"mode": "interactive",
"max_tokens": 4096
}
Documentacao
| Documento | Descricao |
|---|---|
| docs/architecture/ARCHITECTURE_REFACTORING.md | Handler Pattern |
| docs/architecture/MANUAL_DI.md | Dependency Injection |
| docs/architecture/OBSERVABILITY.md | Sistema de observabilidade |
| docs/guides/CONTRIBUTING.md | Como contribuir |
| docs/changes/ | Registro de mudancas recentes |
| ROADMAP.md | Roadmap de desenvolvimento |
| CHANGELOG.md | Historico de alteracoes |
Problemas Comuns
Consulte a secao Performance and Troubleshooting no CLAUDE.md para solucoes de GPU, respostas lentas, timeouts e uso de memoria.
Tecnologias
| Tecnologia | Funcao |
|---|---|
| Go 1.21+ | Linguagem principal |
| Ollama | Modelos de IA locais |
| DuckDuckGo | Busca na web |
| Cobra | CLI framework |
Compatibilidade
| Sistema Operacional | Status |
|---|---|
| Windows | Suportado |
| Linux | Suportado |
| macOS | Suportado |
Licenca
Este projeto esta licenciado sob a GPL-3.0 License.
Contribuindo
- Fork o projeto
- Crie uma branch para sua feature (
git checkout -b feature/nova-feature) - Commit suas mudancas (
git commit -m 'feat: adiciona nova feature') - Push para a branch (
git push origin feature/nova-feature) - Abra um Pull Request
Consulte docs/guides/CONTRIBUTING.md para detalhes.
Suporte
- Abra uma issue para reportar bugs
- Use discussions para perguntas
Directories