Hacktoberfest 2026: le issue che i maintainer hanno segnato per ottobre, aperte e adatte ai principianti. Sfoglia le issue Hacktoberfest

[idea] Docker 04/14: Headless entry for the sidecars

Aperta
  • Qualcosa non va?
#2,104 3 commenti 0 reazioni 1 assegnatario Vedi su GitHub

I maintainer di solito rispondono entro 1 giorno

Nessuno ha ancora preso questa issue.

Valutazione

Difficoltà
4/5
Tempo stimato
3-5 giorni
Idoneità per principianti
55/100
Tipo di issue
Funzionalità
Chiarezza
Specificata chiaramente
Stato di attività
Attiva
Stack tecnologico
node.js, typescript
Ambito
backend, devops

Direzione di ricerca

Read the Docker proposal’s supervisor section and inspect surfsense_local/electron/src/headless/main.ts, electron/src/headless/context-from-env.ts, and boot.ts; this issue depends on #2103 being merged first. Start by checking the package’s Node 24 test setup and the existing boot/context patterns. Done means the documented command starts the API and both workers, /health responds, Ctrl-C stops every child, and context-from-env tests pass.

Scritto dal modello di indicizzazione a partire dal testo della issue.

Descrizione

desktop docker enhancement help wanted

Which part? Desktop app

What would you like?

Step 4 of 14 of #2100: running SurfSense in Docker. Depends on #2103; start once it is merged.

A Node entry that runs the API, the workers and the model servers without Electron, which is what the container will run.

Design: Docker proposal, The supervisor, shared with Electron

What to change

  • surfsense_local/electron/src/headless/main.ts: build the context, call boot.ts, wait for /health, forward SIGTERM and SIGINT to every child, exit when the API exits.
  • electron/src/headless/context-from-env.ts: the data dir, the backend dir, the runtime and model dirs and the secret, from environment variables, with the packaged-only environment (HF_HUB_OFFLINE) set when asked.
  • It runs as TypeScript on Node 24, as the package's tests do; no build step.

Done when

  • On a dev machine, node src/headless/main.ts with the documented variables starts the API and both workers, and /health answers.
  • Ctrl-C stops every child.
  • Tests for context-from-env.ts.

Scope: code and tests only. Don't edit docs/ or AGENTS.md, except to fix a link this change breaks; the maintainers update the docs when the Docker work ships.

Why would it help?

Each step leaves something that runs, so the Docker image is built and reviewed one piece at a time.

Lingua principale
Python
Stelle
16.3k
Fork
1.6k
Merge medio
9h 22m
PR unite (30g)
253

Preparare l'ambiente

Questo progetto non fornisce container di sviluppo, Dockerfile né guida per i contributori, quindi l'ambiente è a tuo carico: parti dal suo README e consulta la nostra guida al primo contributo per i passaggi generali.

Come iniziare

  1. Leggi tutta la issue e poi la guida ai contributi del progetto.
  2. Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
  3. Fai un fork del repository e lavora su un branch.
  4. Apri una pull request che faccia riferimento al numero della issue.

Altre issue di MODSetter/SurfSense

Tutte le issue di MODSetter/SurfSense

Issue simili

Altre issue su Python

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.