Major restructure of the README: - Removed the misleading 'Keine echten LLMs' line from the 'Was es bewusst NICHT kann' section (we now have full Ollama + OpenRouter support with per-agent models). - Added a Highlights table at the top with status badges. - Reorganised Quickstart into 3 paths: rule-based, Ollama, OpenRouter (was a single Ollama path with optional LLM). - New 'Was fehlt gegenüber dem Original' section: clear comparison table mapping each original feature to the Mini equivalent and explaining why we skipped it. - New 'Token-Spar-Design' section: token budgets, model cost examples, explicit 0-cost path via Ollama. - 'Tests' section updated: real test counts per file (was a generic '50+' stat), 99 total, breakdown by file. - 'Time Dilation' section reorganised and made the live-validated observation the headline. - LLM provider section split into Ollama (default) and OpenRouter (opt-in), with a free-model tool-use table and a per-day cost example. - Architecture tree includes engine/time.py, .env.example, tests/ and removes nothing. - Security section moved up and split from 'Tests' cleanly. - All anchors updated and TOC added at the top.
43 lines
1.6 KiB
Text
43 lines
1.6 KiB
Text
# Emergence-Mini environment configuration
|
|
# COPY this file to .env and fill in your own values.
|
|
# .env is git-ignored; do not commit secrets.
|
|
|
|
# === LLM PROVIDER ===
|
|
# Default: Ollama (local, free, no token cost)
|
|
# Set to "openrouter" to use OpenRouter (requires API key below)
|
|
# "auto" picks OpenRouter if OPENROUTER_API_KEY is set, else Ollama
|
|
EMERGENCE_LLM_PROVIDER=ollama
|
|
|
|
# === OPENROUTER (only if EMERGENCE_LLM_PROVIDER=openrouter) ===
|
|
# Get a key at https://openrouter.ai/keys
|
|
# Free models exist but tool-use support is limited; see README.
|
|
OPENROUTER_API_KEY=
|
|
|
|
# Default OpenRouter model (used if no per-agent override)
|
|
EMERGENCE_OPENROUTER_MODEL=anthropic/claude-3.5-haiku
|
|
|
|
# === OLLAMA (default) ===
|
|
# Get Ollama at https://ollama.com — runs locally, no API key, no cost
|
|
# Pull a small fast model: ollama pull llama3.2:3b
|
|
EMERGENCE_OLLAMA_URL=http://127.0.0.1:11434
|
|
EMERGENCE_OLLAMA_MODEL=llama3.2:3b
|
|
|
|
# Per-agent Ollama model overrides. With ~2 GB each, you can run all four
|
|
# on the same machine. Mix and match for Time-Dilation experiments.
|
|
# Examples:
|
|
# EMERGENCE_AGENT_ANCHOR_MODEL=llama3.2:3b
|
|
# EMERGENCE_AGENT_FLORA_MODEL=llama3.2:3b
|
|
# EMERGENCE_AGENT_LOVELY_MODEL=llama3.2:3b
|
|
# EMERGENCE_AGENT_SPARK_MODEL=llama3.2:3b
|
|
|
|
# === BEHAVIOUR ===
|
|
# Master switch: 0 forces rule-based engine (no LLM calls at all)
|
|
EMERGENCE_LLM_ENABLED=1
|
|
EMERGENCE_LLM_TIMEOUT=30
|
|
|
|
# === TOKEN-SAVING TIPS ===
|
|
# - Default model llama3.2:3b is small (~2 GB) and fast
|
|
# - System prompt is already compact (~150 tokens)
|
|
# - max_tokens is capped at 256 — plenty for tool calls
|
|
# - Tool descriptions are short on purpose
|
|
# - For zero-cost operation, use Ollama only (this file)
|