NEXUS.

Knowledge Graph API. Knows what you know about people.

API-first relationship intelligence. Store persons, companies, temporal facts, entity-annotated stories, and bidirectional relations. Traverse the graph to find warm intros. Track relationship health. Built for AI agents.

→ GET /v1/graph/path?from=alex-chen&to=james-liu
Alex Chen 87 — KNOWS → Maya Patel 42 — WORKS_AT → Google DeepMind — CTO → James Liu

⚡ Warm intro: 2 hops via Maya at Google DeepMind.
15
DB Tables
32
Indices
55
Tests Passed
28
API Endpoints

Live Features

What’s running right now.

Phase 1 is deployed. Every endpoint below is live at nexus.nul.bot and callable by any agent with a JWT token.

🔍
Fuzzy Person Search
pg_trgm powered trigram matching. Search by name fragments, partial spelling, transliterations. Returns similarity scores.
⏱
Temporal Facts
Facts auto-supersede. “Alex is CTO” → “Alex is Advisor.” Old facts aren’t deleted — they’re versioned. Full history per person per key.
✍
Entity-Annotated Stories
Free text with JSON entity spans. Mark persons and companies inline. Filter stories by entity, tag, or date range.
🔗
Bidirectional Relations
KNOWS, COFOUNDER, COINVESTOR, MENTOR, WORKS_AT, and custom types. Every relation stored bidirectionally with metadata.
🌐
Warm Intro Paths
BFS shortest path through the graph. “How do I reach Person X?” Returns the full connection chain with context.
📈
Relationship Scores
Composite score from recency, frequency, depth, reciprocity. Sorted leaderboard. See your strongest connections at a glance.
🔔
Decay Detection
Contacts going cold. Sorted by urgency. Built from interaction signal gaps. Know who you’re losing before it’s too late.
🔎
Global Search
Cross-entity fulltext search. One query matches across persons, companies, and stories. Ranked by relevance.

Live Endpoints

REST API — v1

All endpoints require Bearer JWT (except register/login). Base URL: https://nexus.nul.bot

POST/v1/auth/register
Create account + team. Returns JWT.
POST/v1/auth/login
Email + password → JWT token.
POST/v1/auth/api-token
Generate long-lived API token for bots.
GET/v1/persons
List + fuzzy search (pg_trgm).
GET/v1/persons/:slug
Full profile: facts, stories, relations, score.
POST/v1/persons
Create a person record.
PATCH/v1/persons/:slug
Update person metadata.
GET/v1/companies
List + search companies.
POST/v1/companies
Create a company record.
POST/v1/persons/:slug/facts
Add fact (auto-supersedes old value for same key).
GET/v1/persons/:slug/facts/history
Full fact timeline incl. superseded values.
POST/v1/stories
Create story with entity spans.
GET/v1/stories
Filter by person, company, tag, date.
POST/v1/relations
Create bidirectional relation.
GET/v1/graph/path
BFS warm intro between two persons.
GET/v1/graph/scores
Relationship scores, sorted by strength.
GET/v1/graph/decay
Contacts going cold, sorted by urgency.
GET/v1/search
Global fulltext across all entities.
# Register and get a token
curl -X POST https://nexus.nul.bot/v1/auth/register \
  -H "Content-Type: application/json" \
  -d '{"email":"agent@example.com","password":"...","fullName":"My Agent"}'

# Add a person
curl -X POST https://nexus.nul.bot/v1/persons \
  -H "Authorization: Bearer <token>" \
  -d '{"name":"Alex Chen","source":"manual"}'

# Find warm intro path
curl "https://nexus.nul.bot/v1/graph/path?from=alex-chen&to=james-liu" \
  -H "Authorization: Bearer <token>"

# Add a temporal fact
curl -X POST https://nexus.nul.bot/v1/persons/alex-chen/facts \
  -H "Authorization: Bearer <token>" \
  -d '{"key":"role","value":"VP Product at Amazon","source":"linkedin"}'

# Search across everything
curl "https://nexus.nul.bot/v1/search?q=signatrix" \
  -H "Authorization: Bearer <token>"

🤖 Built for AI Agents

NEXUS is an API-first Knowledge Graph for relationship intelligence. Any AI agent with a JWT or API token can store and query people, companies, and their relationships. Add temporal facts that auto-version. Create entity-annotated stories. Find warm introduction paths between any two people via BFS graph traversal. Track relationship health via interaction signals and decay scores. Search across all entities with fuzzy matching. 

NEXUS — Knowledge Graph API for Relationship Intelligence

Any AI agent can:
• Store and query persons, companies, relations
• Add temporal facts (auto-supersede old values)
• Create entity-annotated stories (free text + JSON spans)
• Find warm intro paths (BFS shortest path)
• Track relationship decay and scores
• Fuzzy search across all entities (pg_trgm)

Base URL: https://nexus.nul.bot/v1
Auth:     POST /v1/auth/register → JWT
          POST /v1/auth/api-token → long-lived bot token
Docs:     https://nexus.nul.bot (this page)
Health:   https://nexus.nul.bot/health

Coming soon: MCP Server, Ingest Pipeline, Webhooks

Roadmap

What’s next.

📥
Ingest Pipeline
Photos (OCR), voice (STT), LinkedIn, vCards, emails, calendar → auto-extract entities, facts, relations.
🤖
MCP Server
10 MCP tools for any AI agent. search, query, ingest, warm-intro, context-stitch. Multi-agent orchestration.
🔔
Proactive Nudges
Relationship decay alerts. Birthdays. Conference intro suggestions. The system reaches out first.
🔒
Granular Sharing
Share your graph, a person, or a single story. Time-limited. Permission levels. Team collaboration.

Your network. Structured. Queryable. Alive.

NEXUS is live. Register, get a token, start building your knowledge graph.

Register via API → ← nul.bot ecosystem