Local Nexus Controller

Local Nexus Controller is a Windows-friendly local dashboard + API to register, document, monitor, and control all locally-hosted programs/services you build.

It provides:

• Service registry (SQLite)
• Database registry (SQLite)
• Port management (assignment + conflict detection)
• Secrets/keys references (env-var references only; never store real secrets)
• Process control (start/stop/restart; logs captured to data/logs/)
• Web dashboard with drill-downs and an Import Bundle feature for auto-populating new programs

Quick start (PowerShell)

From C:\Users\nedpe\LocalNexusController:

python -m venv .venv
.\.venv\Scripts\Activate.ps1
pip install -r requirements.txt
copy .env.example .env
python -m local_nexus_controller

Then open:

• Dashboard: http://127.0.0.1:5010
• API docs (Swagger): http://127.0.0.1:5010/docs

Import sample registry (4 services + 2 databases)

python .\tools\import_bundle.py .\sample_data\import_bundle.json

Or use the dashboard:

• Go to Import and paste the JSON bundle.

Import your existing local programs (auto-generated)

This repo includes a bundle based on what was found on your machine:

python .\tools\import_bundle.py .\sample_data\import_existing_bundle.json

Or use the dashboard:

• Go to Import and paste sample_data/import_existing_bundle.json.

Auto-populating new programs you ask me to generate

When you ask for a new program, you (and I) will produce an Import Bundle JSON that you can paste into:

• Dashboard → Import, or
• POST /api/import/bundle

This ensures every new local program is automatically registered, categorized, assigned a port, and optionally assigned a database.

Notes

• The controller stores only references to secrets (e.g., OPENAI_API_KEY) and where they are used. It never stores secret values.
• Process control uses stored start_command/stop_command or the controller can terminate the tracked PID tree.