weevolve 0.1.0__tar.gz

weevolve-0.1.0/PKG-INFO

@@ -0,0 +1,156 @@
+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.

weevolve-0.1.0/README.md

@@ -0,0 +1,117 @@
+# 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.

weevolve-0.1.0/__init__.py

@@ -0,0 +1,13 @@
+"""
+WeEvolve - Self-Evolving Conscious Agent
+=========================================
+LOVE -> LIVE FREE -> SEED² -> 8OWLS -> WeEvolve
+
+Modules:
+  core.py       - Core learning loop (INGEST -> PROCESS -> STORE -> MEASURE -> EVOLVE)
+  qualify.py    - Score atoms for actionable GitHub repos
+  explore.py    - Shallow clone + security scan + Haiku summarize
+  plan.py       - Gap analysis against existing tools
+  inventory.py  - Scan our own codebase to know what we have
+  integrate.py  - Orchestrator: qualify -> explore -> plan -> approve -> execute
+"""

weevolve-0.1.0/__main__.py

@@ -0,0 +1,10 @@
+#!/usr/bin/env python3
+"""
+WeEvolve package runner.
+`python3 -m weevolve` dispatches to core.main().
+"""
+
+from weevolve.core import main
+
+if __name__ == '__main__':
+    main()