Neuralic Core

Neuralic Core is the foundational control layer of the Neuralic platform — a modular AI governance and reasoning system.
This service orchestrates AI modules (like neuralic-trace, neuralic-engine, neuralic-xplain, etc.) by offering:

• Service discovery and registration
• Centralized configuration management
• Access control via JWT and RBAC
• Audit trail collection and decision logs
• Internal and external communication via REST and gRPC

---

🔧 Tech Stack

Layer	Technology
Language	Go
API Layer	REST + gRPC
Database	PostgreSQL
Communication	HTTP + gRPC
Observability	OpenTelemetry (future)
Deployment	Docker + docker-compose

---

📦 Modules in this Repo

Module	Description
registry/	Registers and manages services and modules
auth/	JWT-based authentication and RBAC enforcement
config/	Dynamic configuration for all modules
audit/	Collects and stores decision logs and audit events
policy/	Evaluates platform-wide AI governance policies (WIP)

---

🚀 Running Locally

1. Clone the repo

git clone https://github.com/signalbuilds/neuralic-core.git
cd neuralic-core

---

Getting Started with Docker

To start the Neuralic services using Docker Compose, navigate to your project directory in the terminal and run:

docker-compose up --build

Accessing Neuralic Services

Once the services are up, you can access them via:

• REST API: http://localhost:8080/api
• gRPC: localhost:50051

---

Example API Endpoints

Here are some example endpoints for the REST API:

Method	Endpoint	Description
POST	/api/register	Register a new Neuralic service
POST	/api/audit/log	Submit an audit log entry
GET	/api/services	List registered services

---

Export to Sheets

---

Future Roadmap

The Neuralic team is working on the following enhancements:

• JWT Authentication & Role-Based Access Control (RBAC)
• Live service heartbeats & health checks
• Policy evaluation layer
• Observability integration (OpenTelemetry)
• gRPC streaming API

---

License

No License – © 2025 SignalBuilds / Neuralic Team