Implante o Seeyu Agent Studio na sua própria infraestrutura com Docker ou Kubernetes.
Requisitos
| Recurso | Pequeno | Padrão | Produção |
|---|---|---|---|
| CPU | 2 núcleos | 4 núcleos | 8+ núcleos |
| RAM | 12 GB | 16 GB | 32+ GB |
| Armazenamento | 20 GB SSD | 50 GB SSD | 100+ GB SSD |
| Docker | 20.10+ | 20.10+ | Mais recente |
Pequeno: desenvolvimento, testes, usuário único (1-5 usuários) Padrão: times (5-50 usuários), cargas moderadas Produção: times grandes (50+ usuários), alta disponibilidade, execução intensa de workflows
Os requisitos de recursos são determinados pela execução de workflows (sandbox isolated-vm), pelo processamento de arquivos (parsing de documentos em memória) e por operações vetoriais (pgvector). Normalmente a memória é o fator limitante, não a CPU — tanto o Helm chart quanto o arquivo do compose solicitam 4 Gi para a aplicação e limitam em 8 Gi.
Início Rápido
A auto-hospedagem parte do pacote de implantação — os arquivos do compose, o Helm chart e o
template de .env. Solicite-o em help@seeyu.ai e execute os comandos
abaixo na raiz do pacote descompactado.
cat > .env << EOF
BETTER_AUTH_SECRET=$(openssl rand -hex 32)
ENCRYPTION_KEY=$(openssl rand -hex 32)
INTERNAL_API_SECRET=$(openssl rand -hex 32)
CRON_SECRET=$(openssl rand -hex 32)
EOF
docker compose -f docker-compose.prod.yml up -dO passo do .env não é opcional — o arquivo do compose se recusa a iniciar sem os três primeiros valores, em vez de subir com valores vazios. O CRON_SECRET é o que o agendador usa; sem ele, o serviço cron encerra com instruções e todo o resto continua funcionando. Veja Docker para a configuração completa de produção.
Opções de Implantação
Docker
Implante com Docker Compose em qualquer servidor
Kubernetes
Implante com Helm em clusters Kubernetes
Plataformas de Nuvem
Guias de Railway, DigitalOcean, AWS, Azure e GCP
Qual escolher
Ambos entregam o mesmo conjunto de recursos. O Docker Compose é a forma mais rápida de avaliar o Studio e serve bem para uma instalação de time em um único nó; o Kubernetes é o caminho para alta disponibilidade e segredos gerenciados.
| Capacidade | Docker Compose | Kubernetes (Helm) |
|---|---|---|
| App, realtime, migrações, Postgres, Redis | Sim | Sim |
| Workflows agendados e triggers de polling | Sim — serviço cron | Sim — 18 CronJobs |
| Escalonamento horizontal / HA | Não (nó único) | Sim (replicaCount, HPA, PDB) |
| Segredos gerenciados (Vault, ESO, KMS de nuvem) | .env manual | Sim |
| Network policy, Pod Security Standards | Apenas no nível do host | Sim |
| Supressão de PII, coletor OpenTelemetry | Não incluído | Componentes opcionais |
As diferenças restantes são inerentes à plataforma — o Compose não tem análogo a um HorizontalPodAutoscaler ou a um PodDisruptionBudget. O comportamento da aplicação é o mesmo nos dois.
Para onde ir agora
Integrations & OAuth
Necessário antes de qualquer integração funcionar — comece aqui
Object Storage
Necessário antes de armazenar qualquer coisa que importe
Verify Your Install
Teste de fumaça de dez minutos em todos os subsistemas
A barra lateral cobre o resto: arquitetura, e-mail, Redis, autenticação, jobs em background, rede, segurança, escalonamento, observabilidade e atualizações.
Recursos Enterprise
Organizações, SSO, grupos de permissões, logs de auditoria, whitelabel, políticas de sessão, retenção de dados e data drains funcionam todos em uma implantação auto-hospedada, sem cobrança nem assinatura. Ligue o conjunto com:
ENTERPRISE_ENABLED=true
NEXT_PUBLIC_ENTERPRISE_ENABLED=trueSua implantação também precisa de um modelo de organização para que a maioria deles se aplique. O guia enterprise auto-hospedado cobre os dois padrões, as flags por recurso e a resolução de problemas.
Dependências externas a considerar
O Studio é autossuficiente no editor e no motor de execução principais. Alguns recursos alcançam serviços fora da implantação:
| Recurso | Requer | Observações |
|---|---|---|
| Bases de conhecimento | Uma chave de API da OpenAI, Azure OpenAI ou Gemini | Os embeddings são gerados por um provedor hospedado, selecionado com KB_EMBEDDING_MODEL (text-embedding-3-small por padrão). Não existe backend local de embeddings — bases de conhecimento ficam indisponíveis sem uma dessas chaves. |
| Blocos Agent | Uma chave de API de pelo menos um provedor de modelos | Ou um endpoint auto-hospedado compatível com OpenAI: Ollama, vLLM ou LiteLLM. |
| Módulo Chat | COPILOT_API_KEY gerada em agent-studio.seeyu.ai | Defina NEXT_PUBLIC_CHAT_DISABLED=true para ocultar o módulo em vez disso. |
| Integrações | Seu próprio app OAuth por serviço | Veja Integrações & OAuth. |
| Execução remota de Function / Pi | Chave opcional do E2B ou Daytona | Sem uma delas, código JavaScript de Function que não tenha import nem require ainda roda na VM isolada do próprio processo. Python, Shell, JavaScript com imports externos, Function Sandboxes customizados e Pi exigem um provedor remoto configurado. Veja Segurança. |