Echeo - The Resonant Engine. Find where your code resonates with market needs.
npm install echeoMission: Find where your code resonates with market needs.
Echeo connects your existing code to live bounties. It:
1. Scans your codebase for capabilities (functions, classes, components)
2. Extracts code snippets and generates vector embeddings
3. Summarizes capabilities with AI-generated descriptions
4. Matches your capabilities to bounties/needs using vector similarity
5. Deploys matches by creating new repos and wiring code together
bash
npm install -g echeo
echeo --version
`$3
`bash
cargo install --path .
Or from crates.io (when published)
cargo install echeo
`$3
`bash
git clone https://github.com/repairman29/echeo-core.git
cd echeo-core
cargo build --release
./target/release/echeo --version
`Quick Start
`bash
Install Rust
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | shInstall Ollama (for embeddings and summaries)
brew install ollama
ollama pull nomic-embed-text
ollama pull llama3
ollama serve
`$3
`bash
Scan local code
cargo run -- --path ~/projectsScan GitHub repository
cargo run -- --github-token YOUR_TOKEN --github-repo owner/repoList GitHub repositories
cargo run -- --github-token YOUR_TOKEN --github-listMatch against bounties
cargo run -- --path . --match-needs sample_needs.jsonDeploy a match
cargo run -- --path . --match-needs sample_needs.json --deploy 1Generate loadout.json
cargo run -- --path . --generate-loadout
`š Full Pipeline
$3
- The Crawler: Scans directories, respects .gitignore
- The Shredder: Extracts capabilities from AST
- The Vectorizer: Generates 768-dim embeddings
- The Summarizer: Creates 5-word descriptions$3
- Vector Similarity: Cosine similarity matching
- Ship Velocity Score: Calculates match quality
- The Feed: Tinder-style match cards$3
- The Deployer: Creates repos and wires code
- LLM Wiring: Generates connecting code
- Loadout.json: Exports all capabilitiesš® Example Workflow
`bash
1. Scan your code
cargo run -- --path ~/projects2. Generate embeddings for needs
cargo run -- --embed-needs bounties.json3. Match capabilities to bounties
cargo run -- --path ~/projects --match-needs bounties.json4. Deploy the best match
cargo run -- --path ~/projects --match-needs bounties.json --deploy 15. Polish and ship!
cd deployments/need-1-processpayment
... make it perfect ...
git push origin main
`š Output Example
`
[FEED] THE FEED:[CARD] CARD #1
Title: Solana Meme Coin Dashboard
Bounty: $2,500 (USDC)
Ship Velocity: 87% Match
Your Capability: processPayment
Why: High semantic similarity (85%), Language match: typescript
[DEPLOY] Run: echeo --deploy 1
`š§ CLI Options
`bash
--path # Directory to scan (default: .)
--skip-embeddings # Skip embedding generation
--skip-summaries # Skip summary generation
--match-needs # Match against needs JSON
--embed-needs # Generate embeddings for needs
--deploy # Deploy match by index
--deploy-dir # Deployment directory (default: ./deployments)
--generate-loadout # Generate loadout.json
--github-token # GitHub personal access token
--github-repo # Scan GitHub repository
--github-list # List GitHub repositories
--github-client-id # GitHub OAuth client ID
--scrape-github # Scrape bounties from GitHub Issues (can specify multiple)
--scrape-gitcoin # Scrape bounties from Gitcoin
--gitcoin-limit # Limit for Gitcoin (default: 50)
--scrape-all # Scrape all sources and save to file
--auto-embed-scraped # Auto-embed scraped bounties
--min-score # Minimum match score threshold (default: 0.3)
--ollama-url # Ollama URL (default: http://localhost:11434)
--ollama-model # Embedding model (default: nomic-embed-text)
--ollama-gen-model # Generation model (default: llama3)
`š Project Structure
`
echeo/
āāā src/
ā āāā main.rs # CLI entry point
ā āāā shredder.rs # AST parsing
ā āāā vectorizer.rs # Embedding generation
ā āāā summarizer.rs # Description generation
ā āāā matchmaker.rs # Vector matching
ā āāā deployer.rs # Deployment flow
āāā sample_needs.json # Example needs file
āāā Cargo.toml
``Phase 1: ā
COMPLETE - The Armory
Phase 2: ā
COMPLETE - The Matchmaking Core
Phase 3: ā
COMPLETE - The Battlefield
Phase 4: ā
COMPLETE - The Scraper (Bounty Collection)
GitHub Integration: ā
COMPLETE - Cloud repository scanning
ECHEO is fully operational with all core features.
---
Find where your code resonates.