How uzankhan/numnumdock works
NumNumDock is a local-first LLM deployment tool. The main workflow runs through the CLI: inspect hardware, choose a model, validate Docker, deploy Ollama in an isolated container network, then host an API-key-protected local proxy. The graph also preserves the CLI’s status and doctor commands and the separate native Ollama runtime. Source excerpts show the core calls; README statements support the deployment and proxy flow. The Caddyfile is described as a placeholder, so it is omitted.
Main entry points: cli.py CLI commands · docker_manager.py Container deployment · proxy.py Proxy application · native_manager.py Native Ollama management
Components 15
CLI and diagnostics
- CLI commands
cli.py - Docker validation
cli.py - Status command
cli.py - Doctor command
cli.py
Model deployment
- Hardware detection
core/hardware.py - Model recommendation
core/hardware.py - Container deployment
core/docker_manager.py - Ollama container
core/docker_manager.py - Ollama API
Protected API
- API key generation
core/security.py - Proxy application
core/proxy.py
Native runtime
- Native Ollama management
core/native_manager.py
Other components
- Developer
- Docker daemon
- Local API client
Connections 16
- Developer → CLI commands: invokes
README.md - CLI commands → Hardware detection: inspects
cli.py - CLI commands → Model recommendation: selects model
cli.py - CLI commands → Docker validation: validates
cli.py - CLI commands → Container deployment: deploys
cli.py - Container deployment → Docker daemon: creates resources
core/docker_manager.py - Container deployment → Ollama container: runs container
core/docker_manager.py - Container deployment → Ollama container: pulls model
core/docker_manager.py - CLI commands → API key generation: generates key
cli.py - CLI commands → Proxy application: builds and hosts
cli.py - Local API client → Proxy application: sends requests
README.md - Proxy application → Ollama API: forwards approved requests
core/proxy.py - CLI commands → Status command: runs
cli.py - CLI commands → Doctor command: runs
cli.py - Developer → Native Ollama management: may deploy natively
- Native Ollama management → API key generation: generates key
core/native_manager.py