Inspired by Milorad Paviฤ's "Khazar Dictionary", where truth emerges from multiple voices.
KhazarLLMs brings together AI agents with unique personalities to tackle creative tasks.
Like the Khazar Dictionary, where truth emerges from the intersection of many voices
"The Khazars were a people who disappeared from history, leaving behind only fragments and conflicting accounts.
From these fragments, we can imagine infinite stories. Similarly, from diverse AI perspectives,
infinite creative possibilities emerge."
๐ The Khazar Manifesto
A declaration of collective intelligence and the future of AI
This is the age of the Chorus, not the Solo.
We stand at a threshold in AI evolution. For too long, we've pursued the myth of the omniscient oracleโa single voice with absolute truth. But wisdom emerges not from one voice, but from many.
"One voice speaks. Seven voices converse. And in their conversation, Infinity awakens."
Key Features
A powerful tool for collective AI creativity
๐ค
Multiple Personas
7 unique AI agents with different roles: Dreamer, Critic, Synthesizer, Philosopher, Rebel, Architect, and Poet
๐ฏ
Flexible Orchestration
Sequential, parallel, debate, and consensus modes - choose how agents interact
๐
Iterative Refinement
Multiple conversation rounds to deeply develop ideas
๐พ
Session Management
Save and analyze creative sessions for future reference
๐จ
Provider Agnostic
Works with OpenAI, Anthropic, or mock mode for cost-free experimentation
๐ ๏ธ
CLI & Python API
Use via command line or integrate into your code
Meet the AI Agents
Each agent has a unique personality and creative role
๐ญ
Dreamer
Temperature: 0.95
Generates bold, unbounded creative visions without limitations
๐
Critic
Temperature: 0.4
Analyzes with sharp insight and constructive feedback
๐
Synthesizer
Temperature: 0.7
Weaves disparate ideas into coherent wholes
๐ง
Philosopher
Temperature: 0.6
Explores deep meanings and broader contexts
โก
Rebel
Temperature: 0.9
Challenges assumptions and breaks conventions
๐๏ธ
Architect
Temperature: 0.5
Structures and organizes ideas into implementable forms
โจ
Poet
Temperature: 0.85
Adds beauty and emotional resonance
Quick Start
Get started with KhazarLLMs in minutes
# Clone the repository
git clone https://github.com/NickScherbakov/KhazarLLMs.git
cd KhazarLLMs
# Install dependencies
pip install -r requirements.txt
# Optional: Set up API keys
cp .env.example .env
# Edit .env with your API keys
import asyncio
from khazar_llms.agents.personas import DreamerAgent, CriticAgent, SynthesizerAgent
from khazar_llms.orchestration.ensemble import Ensemble
from khazar_llms.orchestration.session import CreativeSession
async def main():
# Create agents
agents = [
DreamerAgent(provider="mock"),
CriticAgent(provider="mock"),
SynthesizerAgent(provider="mock"),
]
# Create ensemble
ensemble = Ensemble(agents=agents, max_iterations=3)
# Run creative session
session = CreativeSession(ensemble)
results = await session.run("Design a new form of communication")
# View results
for msg in results["conversation"]:
print(f"{msg.sender}: {msg.content}")
asyncio.run(main())
# Get help
python -m khazar_llms.cli info
# List available agents
python -m khazar_llms.cli list-agents
# Run a creative task
python -m khazar_llms.cli create-task "Imagine a library that exists in multiple dimensions"
# Use parallel mode
python -m khazar_llms.cli --mode parallel --agents dreamer rebel poet create-task "Create a new musical instrument"
Use Cases
Real-world applications of KhazarLLMs
โ๏ธ
Creative Writing
Generate stories from multiple narrative perspectives
๐จ
Product Design
Explore product ideas through different lenses
๐งฉ
Problem Solving
Approach complex problems from multiple angles
๐ญ
Art & Poetry
Create multi-layered artistic works
๐ค
Philosophy
Explore philosophical questions through dialogue
๐
Education
Learn topics by seeing multiple explanatory approaches
Join the Project
Become part of the collective AI creativity research community
01
Add New Agents
Create unique AI personas with new creative roles and characteristics
02
Implement Modes
Develop new orchestration patterns and agent interaction methods
03
Improve Dynamics
Optimize dialogues and interactions between agents
04
Create Visualizations
Develop tools to visualize creative processes
05
Write Examples
Add new use case examples for different domains
06
Document
Improve documentation and translate it into other languages
Start Contributing Now!
Read our CONTRIBUTING.md guide and create your first Pull Request