Pular para o conteúdo
canna-oss

Quickstart (alpha)

Pré-requisitos

Seção intitulada “Pré-requisitos”
  • Docker + Docker Compose (Docker Desktop ou colima/orbstack)
  • Bun >= 1.1 ou Node 22
  • Conta Open WebUI local (criada no primeiro acesso)

Passos

Seção intitulada “Passos”

  1. Clone o repo público:

    Terminal window
    git clone https://github.com/biliboss/canna-br.git
    cd canna-br

    (Pre-v0.3: repo público é scaffold mínimo. Código completo vive no vault de desenvolvimento até v0.3 jul/2026.)

  2. Configurar envs:

    Terminal window
    cp .env.example .env
    # edita variáveis: POSTGRES_PASSWORD, REDIS_URL, OWUI_PORT

  3. Subir stack:

    Terminal window
    docker compose up -d

    Sobe Postgres 16 + Redis 7 + Open WebUI v0.9.6 + canna-br MCP server. Cold start ~44s.

  4. Registrar MCP server no Open WebUI:

  5. Validar:

    Terminal window
    curl http://localhost:8765/health
    # esperado: {"ok": true, "version": "v0.2.1.2"}

Smoke test (3 MCP Apps)

Seção intitulada “Smoke test (3 MCP Apps)”

Ver /releases/v021/ para o relato técnico do smoke 2026-06-08.

Limites do quickstart

Seção intitulada “Limites do quickstart”
  • Sem TLS (apenas localhost)
  • Sem backup automatizado
  • Sem audit log externo (vive no Postgres local)
  • Sem integração SNGPC real (mock)

Para produção: aguardar v0.3 (jul/2026) + roadmap self-hosting completo.

Próximos passos

Seção intitulada “Próximos passos”
  • Aplicar como associação seed: /open/seed-associations/
  • Arquitetura: /build/big-picture/
  • Compliance: /build/compliance/