Metadata-Version: 2.4
Name: neuralbridge-middleware
Version: 0.1.1
Summary: Universal Enterprise Middleware for Agentic AI Integration — securely connect ANY AI agent to ANY system with YAML configuration, CRA compliance, and zero-trust security.
Author: NeuralBridge Contributors
License: Apache-2.0
Project-URL: Homepage, https://iceccarelli.github.io/neuralbridge/
Project-URL: Documentation, https://iceccarelli.github.io/neuralbridge/
Project-URL: Repository, https://github.com/iceccarelli/neuralbridge
Project-URL: Issues, https://github.com/iceccarelli/neuralbridge/issues
Project-URL: Changelog, https://github.com/iceccarelli/neuralbridge/releases
Keywords: agentic-ai,ai-agent,middleware,enterprise,openclaw,mcp-gateway,cra-compliance,zero-trust,adapters,langchain,autogpt
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: System Administrators
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
Classifier: Topic :: System :: Systems Administration
Classifier: Framework :: FastAPI
Requires-Python: >=3.11
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: fastapi>=0.110.0
Requires-Dist: uvicorn[standard]>=0.27.0
Requires-Dist: pydantic>=2.6.0
Requires-Dist: pydantic-settings>=2.1.0
Requires-Dist: sqlalchemy[asyncio]>=2.0.25
Requires-Dist: asyncpg>=0.29.0
Requires-Dist: alembic>=1.13.0
Requires-Dist: redis>=5.0.0
Requires-Dist: cryptography>=42.0.0
Requires-Dist: pyjwt>=2.8.0
Requires-Dist: httpx>=0.27.0
Requires-Dist: pyyaml>=6.0.1
Requires-Dist: structlog>=24.1.0
Requires-Dist: opentelemetry-api>=1.22.0
Requires-Dist: opentelemetry-sdk>=1.22.0
Requires-Dist: opentelemetry-instrumentation-fastapi>=0.43b0
Requires-Dist: prometheus-client>=0.20.0
Requires-Dist: tiktoken>=0.6.0
Requires-Dist: jinja2>=3.1.3
Requires-Dist: python-multipart>=0.0.9
Requires-Dist: passlib[bcrypt]>=1.7.4
Requires-Dist: python-jose[cryptography]>=3.3.0
Provides-Extra: dev
Requires-Dist: pytest>=8.0.0; extra == "dev"
Requires-Dist: pytest-asyncio>=0.23.0; extra == "dev"
Requires-Dist: pytest-cov>=4.1.0; extra == "dev"
Requires-Dist: pytest-mock>=3.12.0; extra == "dev"
Requires-Dist: ruff>=0.3.0; extra == "dev"
Requires-Dist: mypy>=1.8.0; extra == "dev"
Requires-Dist: pre-commit>=3.6.0; extra == "dev"
Requires-Dist: httpx>=0.27.0; extra == "dev"
Provides-Extra: docs
Requires-Dist: mkdocs>=1.5.0; extra == "docs"
Requires-Dist: mkdocs-material>=9.5.0; extra == "docs"
Requires-Dist: mkdocstrings[python]>=0.24.0; extra == "docs"
Dynamic: license-file

# NeuralBridge: The Universal Enterprise Middleware for Agentic AI

<p align="center">
  <a href="https://iceccarelli.github.io/neuralbridge/">
    <img src="https://raw.githubusercontent.com/iceccarelli/neuralbridge/main/docs/assets/neuralbridge_concept.png" alt="NeuralBridge Concept Diagram" width="700">
  </a>
</p>

<p align="center">
  <em>The missing infrastructure layer for agentic AI. Proudly developed by <strong>Grimaldi Engineering</strong>.</em>
</p>

<p align="center">
  <a href="https://github.com/iceccarelli/neuralbridge/actions/workflows/ci.yml"><img src="https://github.com/iceccarelli/neuralbridge/actions/workflows/ci.yml/badge.svg" alt="CI Status"></a>
  <a href="https://pypi.org/project/neuralbridge-middleware/"><img src="https://img.shields.io/pypi/v/neuralbridge-middleware.svg?color=blue" alt="PyPI version"></a>
  <a href="https://github.com/iceccarelli/neuralbridge/pkgs/container/neuralbridge"><img src="https://img.shields.io/badge/Docker-ghcr.io-blue?logo=docker" alt="Docker Image"></a>
  <a href="https://opensource.org/licenses/MIT"><img src="https://img.shields.io/badge/License-MIT-yellow.svg" alt="License"></a>
</p>

---

**NeuralBridge** is an open-source, standardized adapter platform that lets ANY AI agent (OpenClaw, AutoGPT, LangChain, Claude, ChatGPT) securely connect to ANY data source, API, or enterprise system with simple YAML configuration.

## The Enterprise Problem: Agents Can Think, But They Can't Act

The agentic AI ecosystem is exploding. Projects like **OpenClaw** prove that agents can reason, plan, and learn. But a critical gap prevents their adoption in the enterprise: how do they **act** in the real world—safely, securely, and at scale?

Enterprises are eager to deploy AI agents to automate complex workflows, but are blocked by fundamental challenges:

- **Security & Compliance:** How do you grant an LLM access to a production database without risking data exfiltration or violating GDPR?
- **Integration Complexity:** How do you connect an agent to a dozen different systems (Salesforce, SAP, Snowflake, etc.) without writing thousands of lines of brittle, custom code?
- **Lack of Standardization:** How do you manage a fleet of agents from different vendors, all speaking different protocols?

**NeuralBridge is the answer.** It provides the secure, standardized infrastructure layer that enterprises need to deploy agentic AI with confidence.

## Why NeuralBridge? The Value Proposition

| Feature | Description |
|---|---|
| **Universal Adapter Framework** | With 22+ pre-built adapters, NeuralBridge is the "Stripe for AI agents." Connect to any database, API, messaging platform, or enterprise system in minutes using simple YAML. |
| **Built-in EU CRA Compliance** | NeuralBridge is designed for the future of AI regulation. It comes ready for the **EU Cyber Resilience Act** (deadline Sept 2026) with immutable audit logs, SBOM generation, and vulnerability reporting. |
| **Zero-Trust Security Engine** | Every connection is protected by role-based access control (RBAC), credential encryption (via Vault), rate limiting, and a secure sandboxing engine that isolates every agent action. |
| **No-Code Configuration** | Business users can connect agents to systems via a beautiful React dashboard. No coding required to create, secure, and deploy a new connection. |
| **Agent-Agnostic Gateway** | A standardized entry point for any agent using the Model Context Protocol (MCP), with native support for the OpenClaw plugin ecosystem. |

## Quick Start

### 1. Docker Compose (Recommended)

```bash
docker compose up -d
```

Visit the dashboard at `http://localhost:3000` and the API docs at `http://localhost:8000/docs`.

### 2. pip

```bash
pip install neuralbridge-middleware
neuralbridge serve
```

## Architecture Overview

<p align="center">
  <a href="https://iceccarelli.github.io/neuralbridge/architecture/">
    <img src="https://raw.githubusercontent.com/iceccarelli/neuralbridge/main/docs/assets/architecture_overview.png" alt="NeuralBridge Architecture Diagram" width="800">
  </a>
</p>

> See the full [Architecture Documentation](https://iceccarelli.github.io/neuralbridge/architecture/) for a deep dive into the components.

## Feature Deep Dive

### Universal Adapter Framework

Connect to anything with our 22+ adapters:

- **Databases**: PostgreSQL, MySQL, MongoDB, Snowflake, BigQuery
- **APIs**: REST, GraphQL, SOAP, OData
- **Messaging**: Slack, Teams, Discord, Telegram, Email
- **Productivity**: Gmail, Notion
- **ERP / CRM**: Salesforce, SAP
- **Cloud**: AWS S3, Azure Blob, Google Cloud Storage

### EU CRA Compliance Engine

NeuralBridge is designed for the future of AI regulation.

- **Immutable Audit Logs**: Hash-chain-verified logs of every agent action.
- **SBOM Generation**: CycloneDX-compliant Software Bill of Materials.
- **Vulnerability Reporting**: Generate CRA Article 14 reports on demand.

### React Dashboard

<p align="center">
  <a href="https://iceccarelli.github.io/neuralbridge/dashboard/">
    <img src="https://raw.githubusercontent.com/iceccarelli/neuralbridge/main/docs/assets/dashboard_screenshot.png" alt="NeuralBridge Dashboard Screenshot" width="800">
  </a>
</p>

- **No-Code Connection Wizard**: Intuitive UI for non-technical users.
- **Compliance Monitoring**: Real-time CRA and GDPR readiness status.
- **Cost Optimization**: Token cost analytics and caching recommendations.

## Example: Connecting an Agent to Salesforce

Create a `salesforce.yaml` file:

```yaml
adapters:
  salesforce:
    type: salesforce
    auth:
      type: oauth2
      client_id: ${SALESFORCE_CLIENT_ID}
      client_secret: ${SALESFORCE_CLIENT_SECRET}
      instance_url: https://yourorg.my.salesforce.com
    permissions:
      - query: "SELECT Id, Name FROM Account"
```

Run the connection:

```bash
neuralbridge connect --config salesforce.yaml
```

Now, any agent can use the `salesforce_query` tool through the NeuralBridge MCP gateway.

## Contributing

We welcome contributions from the community! Please see our [Contributing Guide](CONTRIBUTING.md) to get started.

## Security

For security vulnerabilities, please see our [Security Policy](SECURITY.md).

## Roadmap

See our [Roadmap](ROADMAP.md) for planned features.

## License

NeuralBridge is licensed under the [MIT License](LICENSE).
