Metadata-Version: 2.4
Name: ngcore
Version: 0.63.1
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: GNU Affero General Public License v3
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Rust
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Framework :: FastAPI
Classifier: Framework :: IPython
Classifier: Framework :: Jupyter
Classifier: Operating System :: POSIX :: Linux
Classifier: Operating System :: MacOS :: MacOS X
Requires-Dist: pydantic>=2.5.0
Requires-Dist: typing-extensions>=4.0.0
Requires-Dist: ipython>=8.0.0 ; extra == 'jupyter'
Requires-Dist: jupyter>=1.0.0 ; extra == 'jupyter'
Requires-Dist: notebook>=6.4.0 ; extra == 'jupyter'
Requires-Dist: jupyterlab>=3.0.0 ; extra == 'jupyter'
Requires-Dist: pandas>=1.3.0 ; extra == 'jupyter'
Requires-Dist: networkx>=2.6.0 ; extra == 'jupyter'
Requires-Dist: matplotlib>=3.5.0 ; extra == 'jupyter'
Requires-Dist: plotly>=5.0.0 ; extra == 'jupyter'
Requires-Dist: fastapi==0.109.0 ; extra == 'api'
Requires-Dist: uvicorn[standard]==0.27.0 ; extra == 'api'
Requires-Dist: pydantic==2.5.3 ; extra == 'api'
Requires-Dist: pydantic-settings==2.1.0 ; extra == 'api'
Requires-Dist: python-multipart==0.0.6 ; extra == 'api'
Requires-Dist: python-dotenv==1.0.0 ; extra == 'api'
Requires-Dist: python-jose[cryptography]==3.3.0 ; extra == 'api'
Requires-Dist: passlib[bcrypt]==1.7.4 ; extra == 'api'
Requires-Dist: websockets>=12.0 ; extra == 'api'
Requires-Dist: prometheus-client>=0.19.0 ; extra == 'api'
Requires-Dist: ipython>=8.0.0 ; extra == 'all'
Requires-Dist: jupyter>=1.0.0 ; extra == 'all'
Requires-Dist: notebook>=6.4.0 ; extra == 'all'
Requires-Dist: jupyterlab>=3.0.0 ; extra == 'all'
Requires-Dist: pandas>=1.3.0 ; extra == 'all'
Requires-Dist: networkx>=2.6.0 ; extra == 'all'
Requires-Dist: matplotlib>=3.5.0 ; extra == 'all'
Requires-Dist: plotly>=5.0.0 ; extra == 'all'
Requires-Dist: fastapi==0.109.0 ; extra == 'all'
Requires-Dist: uvicorn[standard]==0.27.0 ; extra == 'all'
Requires-Dist: pydantic==2.5.3 ; extra == 'all'
Requires-Dist: pydantic-settings==2.1.0 ; extra == 'all'
Requires-Dist: python-multipart==0.0.6 ; extra == 'all'
Requires-Dist: python-dotenv==1.0.0 ; extra == 'all'
Requires-Dist: python-jose[cryptography]==3.3.0 ; extra == 'all'
Requires-Dist: passlib[bcrypt]==1.7.4 ; extra == 'all'
Requires-Dist: websockets>=12.0 ; extra == 'all'
Requires-Dist: prometheus-client>=0.19.0 ; extra == 'all'
Requires-Dist: pytest>=7.4.3 ; extra == 'dev'
Requires-Dist: pytest-asyncio>=0.21.1 ; extra == 'dev'
Requires-Dist: pytest-cov>=4.1.0 ; extra == 'dev'
Requires-Dist: httpx>=0.25.2 ; extra == 'dev'
Requires-Dist: ruff>=0.1.0 ; extra == 'dev'
Requires-Dist: mypy>=1.7.0 ; extra == 'dev'
Requires-Dist: black>=23.0.0 ; extra == 'dev'
Provides-Extra: jupyter
Provides-Extra: api
Provides-Extra: all
Provides-Extra: dev
License-File: LICENSE
License-File: LICENSE-DATA
Summary: NeuroGraph - High-performance cognitive platform with Rust Core, WebSocket API, and Jupyter integration
Keywords: neurograph,cognitive-architecture,spatial-computing,ai,ml,jupyter,websocket,real-time,rust,fastapi
Author-email: Chernov Denys <denys@neurograph.org>
License: AGPL-3.0
Requires-Python: >=3.10
Description-Content-Type: text/markdown; charset=UTF-8; variant=GFM
Project-URL: Homepage, https://github.com/chrnv/neurograph-os-mvp
Project-URL: Repository, https://github.com/chrnv/neurograph-os-mvp
Project-URL: Documentation, https://github.com/chrnv/neurograph-os-mvp/blob/main/README.md
Project-URL: Changelog, https://github.com/chrnv/neurograph-os-mvp/blob/main/CHANGELOG.md
Project-URL: Issues, https://github.com/chrnv/neurograph-os-mvp/issues

# NeuroGraph

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

[![Version](https://img.shields.io/badge/version-0.63.1-blue.svg)](https://github.com/chrnv/neurograph-os-mvp)
[![Python](https://img.shields.io/badge/python-3.10+-green.svg)](https://www.python.org/)
[![Rust](https://img.shields.io/badge/rust-2021-orange.svg)](https://www.rust-lang.org/)
[![License](https://img.shields.io/badge/license-AGPL--3.0-blue.svg)](LICENSE)

## 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:**
```bash
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:**
```bash
# 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:**
```python
%load_ext neurograph_jupyter
%neurograph init --path ./my_graph.db
%neurograph query "find all nodes"
```

**Python API:**
```python
from neurograph import NeuroGraph

# Your code here
```

**WebSocket Client:**
```python
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/](docs/)
- **Guides:** [docs/guides/](docs/guides/)
- **Changelog:** [CHANGELOG.md](CHANGELOG.md)

## Development

```bash
# 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](CHANGELOG.md) for detailed history.

## Contributing

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

## License

AGPL-3.0 - See [LICENSE](LICENSE) file for details.

## Links

- **Repository:** https://github.com/chrnv/neurograph-os-mvp
- **Documentation:** [docs/](docs/)
- **Issues:** https://github.com/chrnv/neurograph-os-mvp/issues

