ngcore 0.63.1

NeuroGraph - High-performance cognitive platform with Rust Core, WebSocket API, and Jupyter integration

NeuroGraph

High-performance cognitive platform with Rust Core, WebSocket API, and Jupyter integration

What is NeuroGraph?

NeuroGraph is a cognitive computing platform that combines:

• Rust Core - High-performance event processing (304K events/sec, 0.39μs latency)
• WebSocket API - Real-time bidirectional communication (~5ms latency)
• Jupyter Integration - Interactive notebooks with magic commands
• Web Dashboard - React SPA with real-time monitoring

Quick Start

Installation

From PyPI:

pip install ngcore              # Core package
pip install ngcore[jupyter]     # With Jupyter integration
pip install ngcore[api]         # With WebSocket API
pip install ngcore[all]         # Full installation

From Source:

# Clone repository
git clone https://github.com/chrnv/neurograph-os-mvp.git
cd neurograph-os-mvp

# Install dependencies
pip install -e ".[all]"  # Full installation

Usage

Jupyter Notebook:

%load_ext neurograph_jupyter
%neurograph init --path ./my_graph.db
%neurograph query "find all nodes"

Python API:

from neurograph import NeuroGraph

# Your code here

WebSocket Client:

from neurograph_client import WebSocketClient

client = WebSocketClient("ws://localhost:8000/ws")
await client.subscribe("metrics")

Features

• ✅ Rust Core - 304K events/sec processing
• ✅ WebSocket API - Real-time events with ~5ms latency
• ✅ Jupyter Integration - Magic commands and widgets
• ✅ Web Dashboard - React SPA with monitoring
• ✅ Module Registry - Dynamic module management
• ✅ RBAC - Role-based access control
• ✅ CI/CD - GitHub Actions with pytest and cargo test

Documentation

• Docs: docs/
• Guides: docs/guides/
• Changelog: CHANGELOG.md

Development

# Install development dependencies
pip install -e ".[dev]"

# Run tests
pytest tests/

# Run Rust tests
cd src/core_rust && cargo test

# Build package
maturin build --release

Project Status

Current: v0.63.1 - ~80% complete, ready for PyPI publication

Completed:

• ✅ Rust Core (v0.57.0)
• ✅ WebSocket API (v0.60.0)
• ✅ Jupyter Integration (v0.61.1)
• ✅ Web Dashboard (v0.62.0)
• ✅ Module Registry (v0.63.0)

Next Steps:

• PyPI publication (v0.64.0)
• Production deployment (v0.65.0)

See CHANGELOG.md for detailed history.

Contributing

Contributions are welcome! Please read our contributing guidelines before submitting PRs.

License

AGPL-3.0 - See LICENSE file for details.

Links

• Repository: https://github.com/chrnv/neurograph-os-mvp
• Documentation: docs/
• Issues: https://github.com/chrnv/neurograph-os-mvp/issues