Antes de instalar
- Docker 20.10+ com Docker Compose v2, e o Git.
- Máquina com pelo menos 4 núcleos e 8 GB de RAM (sem contar um modelo local).
- Um modelo de IA: Ollama rodando local, ou uma API compatível com OpenAI (DeepSeek, Qwen…), paga ao provedor.
Instalar (Docker Compose)
WINDOWS, MAC E LINUX · NO TERMINAL
git clone https://github.com/Tencent/WeKnora.git
cd WeKnora
cp .env.example .env
docker compose pull
docker compose up -dAntes do pull, edite o .env e preencha DB_USER, DB_PASSWORD, DB_NAME, REDIS_PASSWORD, JWT_SECRET (gere com openssl rand -hex 32) e SYSTEM_AES_KEY (openssl rand -hex 16). Guarde essas chaves. No Windows, rode o openssl no Git Bash.
Para parar: docker compose down (não use -v: apaga os dados).
Primeiro uso
- Abra
http://localhoste crie a sua conta no primeiro acesso. - Configure o modelo (Ollama ou API) e crie uma base de conhecimento.
- Suba os documentos e pergunte. Confira a fonte de cada resposta.
- Passo a passo com dados de exemplo: Quickstart em
weknora.weixin.qq.com/docs/.
Cuidados
- Rede interna, não internet: o próprio projeto recomenda instalar numa rede interna e não expor o serviço na internet pública. Use firewall e controle de acesso.
- Documentação em chinês: o README é em inglês, mas a documentação completa é quase toda em chinês.
- Dados da empresa: com uma API externa, os trechos dos documentos vão para o provedor do modelo. Para manter tudo em casa, use o Ollama local.
- Atualize sempre para receber as correções de segurança (leia as notas da versão antes).
Links oficiais
github.com/Tencent/WeKnora- Documentação:
weknora.weixin.qq.com/docs/ - Site:
weknora.weixin.qq.com
Passo a passo da documentação oficial do projeto · informações de 12/10/2026 · versão v0.8.2. A Stratia não tem vínculo com o projeto; marcas e imagens pertencem aos seus titulares.