Preview — not yet generally available. Lexicon Hub is documented now so the launch surface is final, but the hosted backend is not yet running. Self-host alternatives are described in the relevant page.

Lexicon Hub

Share, discover, and reuse knowledge packages from the community

Lexicon Hub is a central registry for CCX knowledge packages — portable archives containing templates, entities, relationships, and workflows extracted from documents. Publish your extracted knowledge for others to build on, or pull community packages to jumpstart your own projects.

How It Works

Package Types

Type	Description	Use Case
Full	Complete knowledge graph — templates, entities, relationships	Share a fully extracted knowledge base
Templates	Node and edge type definitions only	Share domain schemas (medical, legal, technical)
Knowledge	Graph entities and relationships	Share extracted data without schema definitions
Workflows	Automation definitions and triggers	Share processing pipelines
Mixed	Any combination of the above	Flexible packaging for partial shares

Quick Start

Pull a package

CLI

# Search for packages
chaoscypher lexicon search "medical ontology"

# Download a package
chaoscypher pull john/medical-ontology

# Import into your database
chaoscypher graph package load john-medical-ontology.ccx

Web UI

1. Navigate to Settings → Lexicon Hub
2. Search for packages by keyword, author, or tag
3. Click Pull to download and import

API

# Search packages
curl "http://localhost:8080/api/v1/lexicon/search?query=medical&sort_by=stars"

# Get package details
curl "http://localhost:8080/api/v1/lexicon/r/john/medical-ontology"

Publish a package

CLI

# Login to Lexicon Hub
chaoscypher lexicon login

# Export your knowledge graph
chaoscypher graph package export --output my-knowledge.ccx

# Publish to the Hub
chaoscypher push my-knowledge.ccx --message "Initial release"

API

# Upload a package (requires authentication)
curl -X POST "http://localhost:8080/api/v1/lexicon/upload?public=true&message=Initial+release" \
  -F "file=@my-knowledge.ccx"

What's in a Package?

A CCX (Chaos Cypher eXchange) package is a compressed archive containing:

my-package.ccx
├── manifest.json           # Package metadata and checksums
├── templates/              # Node and edge type definitions
│   ├── person.json
│   └── organization.json
├── graph/                  # Knowledge graph data
│   ├── entities.jsonld     # Nodes with properties
│   └── relationships.jsonld # Edges with properties
└── workflows/              # Automation definitions
    └── extraction-pipeline.json

Packages are versioned, checksummed, and can be public or private. The manifest includes metadata like author, description, tags, and compatibility information.

Authentication

Lexicon Hub supports two authentication methods:

Method	Best For	How
Device Authorization	Interactive use (recommended)	Browser-based OAuth — chaoscypher lexicon login
Token	CI/CD pipelines	Direct token — chaoscypher lexicon login --token TOKEN

See Authentication for setup details.

Configuration

Configure the Lexicon Hub connection in settings.yaml:

lexicon:
  url: https://lexicon.example.com    # Hub server URL
  api_path: /api/v1                    # API base path
  timeout: 60                          # Request timeout (seconds)

Or set the LEXICON_URL environment variable:

export LEXICON_URL=https://lexicon.example.com

Next Steps

• Discovering Packages — Search, browse, and pull packages from the community
• Publishing Packages — Export and share your knowledge with others
• Authentication — Connect to Lexicon Hub
• CLI Reference — Complete CLI command reference
• API Reference — REST API endpoints