Skip to content

About

Open-source 3D print farm manager for Klipper/Moonraker, with a local Connector and browser-based access.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

1,948 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Open3DFarmManager

Sua farm de impressão, em um só lugar.

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

Página inicial real do Open3DFarmManager, com navegação para Connectors, dispositivos e login.

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.

Por que este projeto?

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.

Conheça a interface

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
Tela real de login com campos de usuário e senha vazios. Tela real de aprovação do Connector, com conferência da impressão digital e controles desabilitados sem autenticação.

Veja a origem e as instruções para atualizar as capturas.

O que já existe e o que vem a seguir

Á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.

Execute localmente

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 dev

Abra 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.

Verificação local

# 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:e2e

O 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.

Como as peças se conectam

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"]
Loading

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.

Contribua

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.

  1. Trabalhe em uma branch com uma mudança bem delimitada.
  2. 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.
  3. Execute pnpm run check:all e descreva os testes feitos e as integrações ainda pendentes.
  4. Abra um draft PR. Não inclua segredos, identificadores de contas privadas ou configuração de hospedagem.

Licença

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.

About

Open-source 3D print farm manager for Klipper/Moonraker, with a local Connector and browser-based access.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages