gknowledge
English · 简体中文 · Italiano · Français · Português (BR) · Español
O LLM Wiki do Karpathy como app nativo do GNOME.
Arraste seus documentos e ganhe uma wiki interligada que um modelo mantém atualizada.
Offline por padrão, sem chave de API, Markdown simples no disco, compatível com Obsidian.
## Instalação
No Ubuntu 24.04+ e Debian 13+ basta uma linha: ela adiciona o repositório APT assinado do gknowledge, e as atualizações chegam com `apt upgrade` (em outras distribuições a instalação vai para `~/.local`):
```bash
curl -fsSL https://github.com/openapi/gknowledge/releases/latest/download/install.sh | bash
```
Ou adicione o repositório APT você mesmo:
```bash
sudo curl -fsSLo /usr/share/keyrings/gknowledge.gpg https://openapi.github.io/gknowledge/gknowledge.gpg
sudo curl -fsSLo /etc/apt/sources.list.d/gknowledge.sources https://openapi.github.io/gknowledge/gknowledge.sources
sudo apt update && sudo apt install gknowledge
```
Em qualquer distribuição, com Flatpak (o runtime do GNOME vem do Flathub):
```bash
flatpak install --user https://openapi.github.io/gknowledge/io.github.openapi.Gknowledge.flatpakref
```
## Feito para funcionar sem internet
Depois de instalado, o gknowledge não precisa de internet, de conta nem de chave de API paga.
- **Motor offline embutido**: importar documentos, montar a wiki e responder com citações funcionam sem nenhum modelo.
- **Pouco consumo de dados**: nada vai para a nuvem por padrão. Se quiser um modelo, o [Ollama](https://ollama.com) roda localmente, baixado uma única vez.
- **Hardware modesto**: um app GTK nativo em Python, sem Electron nem navegador embutido, que roda num notebook Linux comum.
- **Seus dados ficam com você**: Markdown e um índice SQLite numa pasta que você controla.
## Por que gknowledge
Se você já usou [LLM Wiki](https://github.com/nashsu/llm_wiki), [Tolaria](https://github.com/refactoringhq/tolaria), [Reor](https://github.com/reorproject/reor) ou [Khoj](https://github.com/khoj-ai/khoj), já conhece o ciclo: **você importa as fontes, o modelo constrói e mantém uma wiki, e depois você pergunta à wiki.** O gknowledge faz isso como um app GNOME de verdade.
- **Nativo**, GTK 4 e Libadwaita: sem Electron, Tauri ou navegador embutido.
- **Com fontes e revisão**: cada página registra suas fontes, cada resposta as cita, e uma fila de revisão deixa você no controle.
- **Aberto**: licença MIT, a pasta abre no Obsidian.
## Use pelo Claude Code, Codex ou Cursor
```bash
claude mcp add gknowledge -- gknowledge-mcp ~/Knowledge/meu-projeto
```
O agente pode buscar na wiki, ler páginas, fazer perguntas com citações e adicionar novas fontes.
## Escolha o cérebro
| Provedor | Precisa de | Observações |
|---|---|---|
| **Offline** (padrão) | nada | Extração heurística, totalmente privada |
| **Ollama / LM Studio** | um servidor local | Qualquer endpoint compatível com OpenAI |
| **Plano do ChatGPT** | conta Plus ou Pro | Em Preferências, *Sign in with ChatGPT*: o uso sai do seu plano, sem chave de API |
| **Nuvem** | uma chave de API | OpenAI, OpenRouter e similares |
## Contribua
Contribuições são bem-vindas: veja as [*good first issues*](https://github.com/openapi/gknowledge/labels/good%20first%20issue). Traduções para outros idiomas são especialmente bem-vindas.
O resto da documentação está no [README em inglês](README.md). Se o gknowledge for útil para você, uma ⭐ ajuda outras pessoas a encontrá-lo.