Hanzo
ServicesNexus

Hanzo Nexus

AI knowledge base and agent management platform

Hanzo Nexus

Hanzo Nexus is an enterprise AI knowledge base and agent management platform based on Casibase. It provides a unified interface for managing AI models, knowledge bases, MCP servers, and agent-to-agent communication.

Features

  • Knowledge Base Management: RAG-powered document ingestion and retrieval
  • Multi-Model Support: ChatGPT, Claude, Llama, Ollama, HuggingFace
  • MCP Integration: Model Context Protocol server management
  • A2A Communication: Agent-to-agent messaging and orchestration
  • SSO Integration: Built-in single sign-on via Hanzo IAM
  • Admin UI: Full-featured management console

Architecture

+---------------------------------------------------------------+
|                       HANZO NEXUS                              |
+---------------------------------------------------------------+
|                                                                |
|  +---------------------------+  +---------------------------+  |
|  |      Knowledge Base       |  |      Agent Manager        |  |
|  |  +-------+  +----------+  |  |  +-------+  +----------+  |  |
|  |  | Docs  |  | Vectors  |  |  |  | MCP   |  |   A2A    |  |  |
|  |  +-------+  +----------+  |  |  +-------+  +----------+  |  |
|  +---------------------------+  +---------------------------+  |
|                                                                |
|  +---------------------------+  +---------------------------+  |
|  |      Model Registry       |  |      Chat Interface       |  |
|  |  +-------+  +----------+  |  |  +-------+  +----------+  |  |
|  |  | Cloud |  |  Local   |  |  |  | Web   |  |   API    |  |  |
|  |  +-------+  +----------+  |  |  +-------+  +----------+  |  |
|  +---------------------------+  +---------------------------+  |
|                                                                |
+---------------------------------------------------------------+

Endpoints

EnvironmentURL
Productionhttps://nexus.hanzo.ai
Adminhttps://nexus-admin.hanzo.ai
Staginghttps://stg.nexus.hanzo.ai

Quick Start

Development Setup

cd ~/work/hanzo/nexus

# Backend
cd backend && go run main.go

# Frontend (in another terminal)
cd web && npm install && npm start

Docker Compose

docker compose up -d

Access Admin UI

Navigate to http://localhost:7001 and login with IAM credentials.

Knowledge Base

Create Knowledge Base

import { HanzoNexus } from '@hanzo/nexus'

const nexus = new HanzoNexus({
  apiKey: process.env.HANZO_NEXUS_KEY
})

// Create knowledge base
const kb = await nexus.knowledgeBases.create({
  name: 'product-docs',
  model: 'gpt-4o',
  embeddingModel: 'text-embedding-3-large'
})

Upload Documents

// Upload files
await nexus.documents.upload(kb.id, {
  files: [
    { path: 'docs/guide.pdf', type: 'pdf' },
    { path: 'docs/api.md', type: 'markdown' }
  ]
})

// Or add URLs
await nexus.documents.addUrl(kb.id, {
  url: 'https://docs.example.com',
  crawl: true,
  depth: 2
})

Query Knowledge Base

const response = await nexus.chat({
  knowledgeBase: 'product-docs',
  message: 'How do I configure authentication?'
})

Agent Management

MCP Server Configuration

// Register MCP server
await nexus.mcp.register({
  name: 'github',
  endpoint: 'https://mcp.hanzo.ai/github',
  tools: ['search_code', 'create_issue', 'pull_request']
})

A2A Communication

// Define agent
const agent = await nexus.agents.create({
  name: 'code-reviewer',
  model: 'claude-3-opus',
  systemPrompt: 'You are a code review expert...',
  tools: ['github', 'jira']
})

// Agent-to-agent messaging
await nexus.agents.message({
  from: 'code-reviewer',
  to: 'ticket-manager',
  content: { action: 'create-ticket', data: {...} }
})

Model Registry

Supported Providers

ProviderModels
OpenAIGPT-4o, GPT-4 Turbo, o1
AnthropicClaude 3 Opus, Sonnet, Haiku
OllamaLlama 3, Qwen3, Mistral
HuggingFaceAny transformer model
LocalCustom GGUF models

Configure Model

await nexus.models.configure({
  name: 'gpt-4o',
  provider: 'openai',
  apiKey: process.env.OPENAI_API_KEY,
  temperature: 0.7,
  maxTokens: 4096
})

Chat Interface

Web Widget

<!-- Embed chat widget -->
<script src="https://nexus.hanzo.ai/widget.js"></script>
<script>
  HanzoChat.init({
    knowledgeBase: 'product-docs',
    theme: 'dark'
  })
</script>

API

curl -X POST https://nexus.hanzo.ai/api/chat \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "knowledgeBase": "product-docs",
    "message": "How do I get started?"
  }'

SSO Integration

Nexus integrates with Hanzo IAM for authentication:

// Configure SSO
await nexus.sso.configure({
  provider: 'hanzo-iam',
  clientId: 'app-nexus',
  issuer: 'https://iam.hanzo.ai'
})

Configuration

Environment Variables

# Database
DB_HOST=localhost
DB_PORT=5432
DB_NAME=nexus

# Redis
REDIS_URL=redis://localhost:6379

# IAM
IAM_ENDPOINT=https://iam.hanzo.ai
IAM_CLIENT_ID=app-nexus

# Vector Store
VECTOR_ENDPOINT=https://vector.hanzo.ai
VECTOR_API_KEY=xxx

# Models
OPENAI_API_KEY=sk-xxx
ANTHROPIC_API_KEY=sk-ant-xxx

Docker Deployment

docker pull hanzoai/nexus:latest

docker run -d \
  --name hanzo-nexus \
  -p 7001:7001 \
  -e DB_HOST=postgres \
  -e REDIS_URL=redis://redis:6379 \
  hanzoai/nexus:latest

Next Steps

Vector

Vector similarity search

Gateway

AI inference gateway

How is this guide?

Last updated on

Hanzo Bot

Skill-based AI assistant platform with 743+ skills, 35+ channel integrations, persona management, and a plugin SDK for extending capabilities.

Hanzo Vector

High-performance vector search engine for AI applications

On this page

Hanzo Nexus
Features
Architecture
Endpoints
Quick Start
Development Setup
Docker Compose
Access Admin UI
Knowledge Base
Create Knowledge Base
Upload Documents
Query Knowledge Base
Agent Management
MCP Server Configuration
A2A Communication
Model Registry
Supported Providers
Configure Model
Chat Interface
Web Widget
API
SSO Integration
Configuration
Environment Variables
Docker Deployment
Next Steps