Documentation

Developer documentation and API reference for building with Yohanun

Login Start Building

Welcome to Yohanun

Yohanun is a semantic runtime that gives your applications persistent memory, automated reasoning, and contextual intelligence. While others build chatbots, you'll build genuinely intelligent applications.

The Yohanun Difference

Rules + Memory = Experience. Yohanun doesn't just store data—it understands context, remembers relationships, and spots patterns that make your applications feel like they "just get it."

Quick Start

Get your first intelligent application running in under 5 minutes:

1. Get Your API Key
  1. Register for a developer account
  2. Generate an API key in your dashboard
  3. Note your API key for use in requests:
X-API-Key: sile_nidgbNEmjc9zmPx6lo9VLwTKGR9qHmuPgphMpeh3ltQ
Pro Tip: Your API key includes intelligent rate limiting and cost controls built-in.
2. Make Your First AI Chat Request
curl -X POST http://localhost:8000/api/ai/chat \ -H "X-API-Key: sile_nidgbNEmjc9zmPx6lo9VLwTKGR9qHmuPgphMpeh3ltQ" \ -H "Content-Type: application/json" \ -d '{ "message": "I'm frustrated with the slow response from your app", "context": { "user_id": "alice", "session_id": "session_123" } }'

What the API automatically provides:

  • 🤖
    Intelligent Response: AI-powered conversational responses
  • 🎯
    Intent Detection: Automatically categorizes user intent
  • 🧠
    Memory Storage: Stores conversation context for future use
  • ⚙️
    Model Selection: Uses best available AI model for the task

Authentication

All API requests require authentication using your API key in the request header:

X-API-Key: yohanun_your_api_key_here
Secure by Design

API keys use SHA-256 hashing and include automatic rate limiting, cost controls, and usage tracking.

Multi-App Support

Create separate API keys for different applications with isolated contexts and independent usage tracking.

Keep your API key secure! Never expose it in client-side code or public repositories.

Persistent Memory System

SILE's memory system stores and retrieves contextual information across sessions, building understanding that makes your applications genuinely intelligent.

POST /api/memory/memories
Store Contextual Memory
{ "content": "User Alice prefers morning meetings and uses iPhone", "context": "user_preferences_alice", "tags": ["preferences", "meetings", "device"], "metadata": { "category": "preferences", "importance": "high", "source": "conversation" } }
Search Memory
curl -X POST http://localhost:8000/api/memory/search \ -H "X-API-Key: sile_nidgbNEmjc9zmPx6lo9VLwTKGR9qHmuPgphMpeh3ltQ" \ -H "Content-Type: application/json" \ -d '{ "query": "Alice meeting preferences", "limit": 5 }'
Memory Statistics
curl -X GET http://localhost:8000/api/memory/stats \ -H "X-API-Key: sile_nidgbNEmjc9zmPx6lo9VLwTKGR9qHmuPgphMpeh3ltQ"
Example Response
{ "query": "Alice meeting preferences", "results": [ { "content": "User Alice prefers morning meetings and uses iPhone", "context": "user_preferences_alice", "tags": ["preferences", "meetings", "device"], "metadata": {"category": "preferences"}, "created_at": "2024-01-15T10:30:00Z" } ], "total": 1 }

Support & Resources

Documentation

Complete API reference and architecture guides

View Code Examples →
Support

Get help with integration and troubleshooting

Contact Support →