NeuronHub

A hosted agent builder, control plane for NeuronAgent, secure gateway for runtime, and one-click embed platform. Multi-tenant SaaS powered by NeuronDB and NeuronAgent.

Documentation

• docs/ – API overview, embed widget, quickstart, release notes.

User Journey

Land → Sign up → Create agent → Test → Publish → Copy snippet → Paste → Live.

Repository Structure

• frontend — Next.js 15 app (dashboard, agent builder, playground, settings)
• backend — Go API server (auth, agents, knowledge, billing)
• gateway — Go API gateway (public runtime proxy to NeuronAgent)
• widget — Embeddable chat widget (vanilla TS, CDN-served)
• sdk-js — TypeScript/JavaScript SDK
• sdk-python — Python SDK
• infrastructure — Docker, Helm, Terraform
• docs — Documentation site

Quick Start

# Start all services (PostgreSQL, backend, gateway, frontend)
make dev

# Backend API: http://localhost:8081
# Gateway: http://localhost:8082
# Frontend: http://localhost:3000

Running without Docker

To run backend, gateway, and frontend without Docker:

1. Database: Set DATABASE_URL in .env (default: postgres://neuronhub:neuronhub@localhost:5434/neuronhub?sslmode=disable) and ensure Postgres is running. Run migrations: make migrate.
2. CORS: Add your frontend origin to CORS_ORIGIN in .env (e.g. http://localhost:3002, http://localhost:3003). Restart the backend after changing .env.
3. Start services: Backend and gateway (e.g. ./run.sh -d --binary neurondb-hub, ./run.sh -d --binary gateway), then frontend from src/frontend (npm run dev). If login shows "Network Error", ensure the backend is reachable at the URL the frontend uses (see NEXT_PUBLIC_API_URL) and that your browser’s origin is listed in CORS_ORIGIN.

API

REST API is under /api/v1/. OpenAPI/Swagger spec can be generated from the backend (see docs/ for runbooks). All endpoints require authentication except signup/login and health.

Requirements

• Go 1.23+
• Node.js 18+
• PostgreSQL 17
• (Optional) NeuronAgent + NeuronDB for full runtime

Deploy with NeuronDB platform

To run Hub together with the full NeuronDB stack (neurondb + neurondb-cloud + neurondb-hub) on a single host, use the deploy script from the neurondb repo. Place neurondb, neurondb-cloud, and neurondb-hub as sibling directories, then from the neurondb repo run:

./scripts/deploy-all.sh TARGET_HOST [LOCAL_BASE_DIR]

On the platform, Hub is exposed at: Backend http://HOST:8084, Gateway http://HOST:8085, Frontend http://HOST:3001 (Hub DB on port 5434). The script sets NEURONAGENT_URL so Hub backend and gateway can reach NeuronAgent on the shared Docker network. Optionally set NEURONDB_CLOUD_API_URL (e.g. http://HOST:8083) and NEURONDB_CLOUD_API_KEY to use neurondb-cloud as backend.

Contributing

We welcome contributions. See CONTRIBUTING.md for how to get started, and CODE_OF_CONDUCT.md for community standards. Please report security issues as described in SECURITY.md.

License

Proprietary. See LICENSE.