Nevron

Nevron - Lightweight AI Agent Framework

[](https://github.com/axioma-ai-labs/nevron/actions/workflows/main.yml) [](https://codecov.io/gh/axioma-ai-labs/nevron) [](https://github.com/axioma-ai-labs/nevron/actions/workflows/docker.yml) [](https://axioma-ai-labs.github.io/nevron/)

Build flexible autonomous AI agents effortlessly. Set up in 2 minutes, run in 5, deploy in 10.

Quick Start

Prerequisites

• Python 3.11+
• Node.js 18+ (for dashboard)
• Poetry (pip install poetry)

Installation

# Clone the repository
git clone https://github.com/axioma-ai-labs/nevron.git
cd nevron

# Install Python dependencies
make deps

# Install dashboard dependencies
make dashboard-deps

Running Nevron

# Start everything (Agent + API + Dashboard)
make dev-full

This starts:

• Dashboard: http://localhost:5173
• API: http://localhost:8000
• Agent: Running in background

Configuration

**All configuration is done through the Dashboard UI** - no `.env` file needed!

1. Open the dashboard at http://localhost:5173
2. Go to Settings page
3. Configure your LLM provider and API key
4. Set up agent personality and goals
5. Enable integrations as needed

Configuration is saved to `nevron_config.json` and loaded automatically.

Architecture

Nevron uses a decoupled architecture where the API and Agent run as independent processes:

┌─────────────────┐     ┌──────────────────┐     ┌─────────────────┐
│   Dashboard     │────▶│   FastAPI        │────▶│  Shared State   │
│   (Svelte)      │     │   (Port 8000)    │     │  ./nevron_state │
│   Port 5173     │◀────│   + WebSocket    │◀────│