weevolve 0.1.0

Self-evolving knowledge engine. Learn from anything. Level up forever.

WeEvolve

Learn from anything. Level up forever.

WeEvolve is a self-evolving knowledge engine that turns URLs, files, and text into structured knowledge using the SEED protocol. Track your learning with RPG-style progression -- levels, XP, skills, and streaks.

Install

pip install weevolve

# With AI-powered extraction (recommended):
pip install "weevolve[ai]"

Quick Start

# Set your API key (optional -- works without it too)
export ANTHROPIC_API_KEY="your-key-here"

# Learn from a URL
weevolve learn https://example.com/interesting-article

# Learn from text
weevolve learn --text "Key insight: parallel agents are 10-18x faster than serial"

# See your character sheet
weevolve status

# Search your knowledge
weevolve recall "parallel agents"

# Run as daemon (auto-learns from bookmarks every 5 min)
weevolve daemon

How It Works

Every piece of content is processed through 8 SEED phases:

1. PERCEIVE -- What are the key facts?
2. CONNECT -- How does this relate to what you already know?
3. LEARN -- What is the one key takeaway?
4. QUESTION -- What assumptions should be challenged?
5. EXPAND -- What opportunity does this reveal?
6. SHARE -- What is the shareable insight?
7. RECEIVE -- What feedback does this give you?
8. IMPROVE -- How should this change how you operate?

Each learning earns XP, improves skills, and levels you up.

Features

• 14 skill categories tracked automatically
• Quality scoring (0.1-1.0) with alpha discovery detection
• Streak tracking for consistent learners
• Genesis export/import -- share knowledge between instances (PII-stripped)
• Works offline -- fallback extraction when no API key
• SQLite storage -- your knowledge lives in ~/.weevolve/

Data Location

All data stored in ~/.weevolve/:

• weevolve.db -- knowledge atoms
• weevolve_state.json -- your character sheet
• evolution_log.jsonl -- learning history
• bookmarks/ -- drop files here for daemon to process

Override with: export WEEVOLVE_DATA_DIR=/your/path

Genesis (Knowledge Sharing)

# Export your knowledge (PII-stripped)
weevolve genesis export

# Export only high-quality atoms
weevolve genesis export --curated

# Import someone else's knowledge to bootstrap
weevolve genesis import path/to/genesis.db

# See genesis stats
weevolve genesis stats

All Commands

weevolve learn <url>                  # Learn from a URL
weevolve learn --text "content"       # Learn from raw text
weevolve learn --file /path/to/file   # Learn from a file
weevolve scan                         # Process bookmark files
weevolve status                       # Show evolution dashboard
weevolve quest                        # Show active quests
weevolve recall <query>               # Search what you've learned
weevolve daemon                       # Run as continuous daemon
weevolve genesis export [path]        # Export genesis.db (PII-stripped)
weevolve genesis export --curated     # Export curated (quality >= 0.7 only)
weevolve genesis import <path>        # Import genesis.db to bootstrap
weevolve genesis stats                # Show genesis database stats
weevolve genesis top [limit]          # Show top learnings

Requirements

• Python 3.9+
• requests (installed automatically)
• anthropic (optional, for AI-powered extraction)

License

MIT. Built by 8OWLS.