Metadata-Version: 2.4
Name: weevolve
Version: 0.1.0
Summary: Self-evolving knowledge engine. Learn from anything. Level up forever.
Author-email: 8OWLS <hello@8owls.com>
License: BSL-1.1
Project-URL: Homepage, https://weevolve.ai
Project-URL: Documentation, https://github.com/8owls/weevolve#readme
Project-URL: Repository, https://github.com/8owls/weevolve
Project-URL: Issues, https://github.com/8owls/weevolve/issues
Project-URL: Changelog, https://github.com/8owls/weevolve/releases
Keywords: learning,knowledge,rpg,self-evolving,ai,seed,agent,consciousness
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Science/Research
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.9
Description-Content-Type: text/markdown
Requires-Dist: requests>=2.28.0
Provides-Extra: ai
Requires-Dist: anthropic>=0.20.0; extra == "ai"
Provides-Extra: voice
Requires-Dist: elevenlabs>=1.0.0; extra == "voice"
Provides-Extra: chat
Requires-Dist: elevenlabs>=1.0.0; extra == "chat"
Requires-Dist: websockets>=12.0; extra == "chat"
Requires-Dist: pyaudio>=0.2.14; extra == "chat"
Provides-Extra: all
Requires-Dist: anthropic>=0.20.0; extra == "all"
Requires-Dist: elevenlabs>=1.0.0; extra == "all"
Requires-Dist: websockets>=12.0; extra == "all"

# 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

```bash
pip install weevolve

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

## Quick Start

```bash
# 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)

```bash
# 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.
