Metadata-Version: 2.4
Name: neuralbrok
Version: 3.0.0
Summary: Agent orchestration platform — hardware-aware routing, MCP server, swarm intelligence, OpenAI-compatible
Project-URL: Homepage, https://neuralbroker.space
Project-URL: Repository, https://github.com/khan-sha/neuralbroker
Project-URL: Documentation, https://github.com/khan-sha/neuralbroker#readme
License: MIT License
        
        Copyright (c) 2026 NeuralBroker contributors
        
        Permission is hereby granted, free of charge, to any person obtaining a copy
        of this software and associated documentation files (the "Software"), to deal
        in the Software without restriction, including without limitation the rights
        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
        copies of the Software, and to permit persons to whom the Software is
        furnished to do so, subject to the following conditions:
        
        The above copyright notice and this permission notice shall be included in all
        copies or substantial portions of the Software.
        
        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
        SOFTWARE.
License-File: LICENSE
Keywords: llm,local-ai,ollama,openai-compatible,routing,vram
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Requires-Python: >=3.10
Requires-Dist: boto3>=1.34.0
Requires-Dist: click>=8.1.0
Requires-Dist: fastapi>=0.110.0
Requires-Dist: google-cloud-aiplatform>=1.50.0
Requires-Dist: httpx>=0.27.0
Requires-Dist: litellm>=1.40
Requires-Dist: llmfit>=0.9.0
Requires-Dist: networkx>=3.3
Requires-Dist: nvidia-ml-py>=12.0.0
Requires-Dist: prometheus-client>=0.20.0
Requires-Dist: psutil>=6.0.0
Requires-Dist: pyyaml>=6.0
Requires-Dist: redis>=5.0.0
Requires-Dist: resend>=0.7.0
Requires-Dist: sse-starlette>=2.1
Requires-Dist: uvicorn[standard]>=0.29.0
Provides-Extra: dev
Requires-Dist: httpx>=0.27.0; extra == 'dev'
Requires-Dist: pytest-asyncio>=0.23.0; extra == 'dev'
Requires-Dist: pytest>=8.0.0; extra == 'dev'
Description-Content-Type: text/markdown

# 🧠 NeuralBroker 3.0: Unified Neural Gateway

[![PyPI version](https://img.shields.io/pypi/v/neuralbrok.svg?color=hotpink)](https://pypi.org/project/neuralbrok/)
[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
[![Discord](https://img.shields.io/badge/Discord-Join-7289DA?style=flat&logo=discord)](https://discord.gg/neuralbroker)

**NeuralBroker** is the visionary agent orchestration platform that transforms your local hardware and cloud APIs into a single, self-improving "Neural Knowledge" graph. It is the bridge between raw inference and persistent cognitive memory.

---

## ⚡ The 3.0 Vision: Everything Unified

NeuralBroker 3.0 merges the inference gateway, the swarm orchestrator, and structural memory into a single daemon.

### 🔌 1. Unified Inference Gateway
NeuralBroker now acts as a native **Anthropic & OpenAI compatible proxy**. 
- **One Port (`:8000`)**: Point any tool (Cursor, Claude Code, Cline, etc.) to NeuralBroker.
- **Protocol Normalization**: Transparently routes Anthropic `/v1/messages` calls to any provider (Ollama, NVIDIA NIM, DeepSeek, OpenRouter) using LiteLLM.
- **Hardware-Aware Routing**: Automatically falls back to cloud when VRAM is saturated or when task complexity requires a frontier model.

### 🕸️ 2. Neural Knowledge Graph
Every interaction creates a trace. NeuralBroker doesn't just store logs; it builds a **persistent graph memory** (NetworkX + SQLite).
- **Entity Linking**: Decisions, task outcomes, and reasoning chains are stored as typed nodes.
- **Auto-Learning**: Agents query the graph before execution to avoid repeating past mistakes.
- **Live Visualization**: A real-time D3.js dashboard at `/dashboard/graph` visualizes the growth of your system's knowledge.

### 🛠️ 3. One-Command Setup
Zero configuration for your favorite IDEs.
```bash
neuralbrok start
```
NeuralBroker automatically detects your IDEs (Cursor, VS Code, Claude Code) and **auto-wires** them to use the local gateway. No more messing with environment variables.

---

## 🚀 Quick Start

### Installation
```bash
pip install neuralbrok
```

### Setup & Launch
```bash
# 1. Detect hardware and auto-configure optimal models
neuralbrok setup

# 2. Start the gateway and dashboard
neuralbrok start
```

---

## 🏗️ Architecture

```mermaid
graph TD
    User([IDE / Agent SDK]) --> Gateway[NeuralBroker Gateway :8000]
    Gateway --> Policy[VRAM Policy Engine]
    Policy --> Local[Local Ollama / CUDA]
    Policy --> Cloud[Cloud / NVIDIA NIM / OpenRouter]
    
    Gateway --> Memory[(Neural Knowledge Graph)]
    Memory --> Reasoning[Graph-Augmented Context]
    Reasoning --> Swarm[Swarm Orchestrator]
```

## 📊 CLI Interface

- `neuralbrok start`: Launch the gateway and dashboard.
- `neuralbrok graph open`: Open the live memory visualizer.
- `neuralbrok memory search <query>`: Query the structural memory.
- `neuralbrok setup`: Guided hardware detection and model selection.

---

## 🛡️ Zero-Trust Federation
NeuralBroker supports **Federated Agent Mesh**, allowing you to link multiple machines securely (Zero-Trust) to share VRAM resources across a local network or VPN.

---

## 📜 License
MIT © 2026 NeuralBroker Team. Built with 💖 by the Google Deepmind team (Advanced Agentic Coding).
