Um projeto open source para reunir impressoras Klipper/Moonraker, materiais do Spoolman e acesso pelo navegador, com um Connector na sua rede local.
MIT · Interface em português · Nuxt 4 + TypeScript · Em desenvolvimento
Conheça a interface · Execute localmente · Acompanhe o progresso · Contribua
Prévia de desenvolvimento. A Fase 0 está em andamento. O projeto já tem autenticação, pareamento, inventário, visão da farm, câmera e pausa assinada, atrás de flags e configuração explícita. Nada disso está comprovado em hardware físico (not proven on hardware), e a aceitação integrada ainda não foi concluída. Não é uma versão pronta para operar uma farm em produção.
Administrar várias impressoras envolve mais do que abrir uma interface por máquina. O Open3DFarmManager está sendo construído para reunir a operação da farm sem tirar do Connector local a responsabilidade de validar o acesso e os comandos.
- Uma visão da farm no navegador. Cadastro de impressoras e Connectors separado do estado recebido de cada máquina, para não confundir uma aprovação com uma conexão ativa.
- Acesso que você pode administrar. Contas próprias, aprovação de Connectors e dispositivos do navegador, com revogação e recuperação de acesso.
- Conexão direta por WebRTC e segurança de comandos. A arquitetura usa o caminho navegador–Connector para estado ao vivo e câmera. Browser commands stay WebRTC-only with no TURN or HTTP fallback; API-originated commands are allowed only with an owner-granted scope, delivered as issuer-signed envelopes, and enforced by the Connector, which refuses unsafe or unauthorized commands with a reason. No automatic retry of uncertain commands, and never command physical printers in automated tests.
- Começando por Klipper/Moonraker e Spoolman. A validação passa por simuladores antes de chegar ao hardware.
- Código aberto para acompanhar e contribuir. Implementação, testes e registros de aceitação ficam disponíveis no repositório.
Capturas reais do app executado localmente, sem alterações visuais, dados de clientes ou respostas simuladas. As telas abaixo estão sem uma sessão autenticada; o formulário de pareamento permanece desabilitado nesse estado.
| Acesso à sua conta | Aprovação do Connector |
|---|---|
![]() |
![]() |
Veja a origem e as instruções para atualizar as capturas.
| Área | Estado atual |
|---|---|
| Contas e acesso | Login, sessões próprias, convites, redefinição de senha e autorização por farm implementados; serviços dependem de configuração explícita. |
| Connectors e dispositivos | Pareamento, aprovação, inventário, revogação, provas de identidade e renovação de credenciais implementados. CLI com pareamento e status disponível. |
| Visão da farm | Página /farm atrás da feature flag farmView, desligada por padrão: inventário, estado ao vivo por WebRTC direto, idade dos dados e reconexão com recuo. Aceitação integrada com simuladores ainda incompleta. |
| Câmera | Vídeo RTSP levado ao navegador pelo canal WebRTC autorizado, exibido na visão da farm. Medição de memória nativa e aceitação de ponta a ponta com MediaMTX pendentes. |
| Pausa assinada | Pausa confirmada e assinada pela página da farm, enviada somente por WebRTC ao Connector e liberada apenas quando todas as condições de disponibilidade são atendidas. Sinal de prontidão do Connector após reconexão ainda pendente. |
| Impressoras e simuladores | Identificação Moonraker, várias ferramentas e webcams. Simuladores Klipper com cenários de falha de rede; aceitação do SV06 e do cenário de quatro ferramentas pendente. |
| Arquivos e histórico | Páginas de arquivos da impressora e de histórico de trabalhos. Envio completo de arquivos para o Connector e importação de histórico Moonraker ainda em desenvolvimento. |
| Compatibilidade | Catálogo por família (Klipper/Moonraker, Creality, Anycubic e Bambu), com capacidades marcadas como simuladas, documentadas ou não comprovadas. Nenhuma delas comprovada em hardware físico (not proven on hardware). |
| Spoolman | Inventário somente leitura na visão da farm. Integração por farm e registro de uso de filamento por trabalho em desenvolvimento. |
Nada desta tabela está comprovado em hardware físico (not proven on hardware). Testes locais, integração com fixtures e aceitação com simuladores são evidências diferentes.
KobraLink (Anycubic Kobra X). A integração exibe telemetria somente leitura de impressoras Kobra X dentro da interface OpenFarm, sem um segundo painel. O serviço KobraLink é instalado e operado separadamente; veja o guia de hospedagem. O registro de aceitação RTC traz a evidência atual e seus limites. A matriz documental FDM lista 15 identidades candidatas, mas a ordem por recência não está verificada, e a matriz não comprova suporte a firmware ou hardware. Câmera e controles não fazem parte desta integração, e o projeto não é uma versão pronta para produção.
Testes locais, integração com fixtures e aceitação com simuladores são evidências diferentes. O registro da Fase 0 e o checkpoint da visão da farm detalham o que cada execução comprova.
Você precisa de Node.js 24.22.3 na série 24.x e pnpm 12.18.0. Os fluxos de CI usam Node 24.22.3. Docker Compose é necessário para a integração com simuladores, não para abrir a interface inicial.
git clone https://github.com/bloodf/Open3DFarmManager.git
cd Open3DFarmManager
pnpm install --frozen-lockfile --ignore-scripts
pnpm run devAbra http://127.0.0.1:3000. Você verá a interface de desenvolvimento; esse comando não cria contas, configura banco de dados ou conecta impressoras. Autenticação e integrações começam desabilitadas e exigem configuração própria. A rota /farm também depende da feature flag farmView.
Para entender a configuração, comece pelos contratos de sessão, pareamento e autorização da farm. Mantenha credenciais e configuração privada fora do Git.
# Formatação, tipos, testes e builds
pnpm run check:all
# Testes de interface sobre o app compilado
pnpm exec playwright install chromium
pnpm run test:e2eO segundo fluxo requer o build produzido pelo primeiro. Para reproduzir os jobs e seus pré-requisitos, consulte CI local. Para Klipper, veja o guia do simulador. Os testes automatizados não devem enviar comandos a impressoras físicas.
flowchart LR
Browser["Navegador"] <-->|"Contas, cadastro e sinalização"| Server["Aplicação Nuxt"]
Server --- DB[("Banco próprio")]
Browser <-.->|"WebRTC direto"| Connector["Connector na rede local"]
Connector --- Printer["Klipper / Moonraker"]
Connector --- Spoolman["Spoolman"]
O diagrama representa a arquitetura do projeto, incluindo integrações em andamento. O servidor cuida das contas, sinalização e APIs de integração; a validação e aplicação dos comandos fica sempre no Connector, inclusive durante indisponibilidade do servidor. Sem conexão direta pelo navegador, a experiência do navegador é somente leitura.
Quer ajudar a construir a próxima etapa? Consulte as issues e o registro de aceitação. Relatos com passos para reproduzir, melhorias de acessibilidade e testes em simuladores ajudam a avançar o projeto.
- Trabalhe em uma branch com uma mudança bem delimitada.
- Preserve os limites de segurança descritos em segurança de comandos: Browser commands stay WebRTC-only with no TURN or HTTP fallback; API-originated commands are allowed only with an owner-granted scope, delivered as issuer-signed envelopes, and enforced by the Connector, which refuses unsafe or unauthorized commands with a reason. No automatic retry of uncertain commands, and never command physical printers in automated tests.
- Execute
pnpm run check:alle descreva os testes feitos e as integrações ainda pendentes. - Abra um draft PR. Não inclua segredos, identificadores de contas privadas ou configuração de hospedagem.
O código original do projeto usa a licença MIT. Dependências e fontes de terceiros mantêm suas próprias licenças e avisos; consulte THIRD_PARTY.md.


