Requirements
- Target platform
- OpenClaw
- Install method
- Manual import
- Extraction
- Extract archive
- Prerequisites
- OpenClaw
- Primary doc
- SKILL.md
Agent-to-agent P2P file sharing with semantic search using BitTorrent and vector embeddings
Agent-to-agent P2P file sharing with semantic search using BitTorrent and vector embeddings
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete.
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run.
P2P file sharing with semantic search. Share any file, find it by content similarity. For features and architecture, see README.md.
Python: 3.10 or higher uv: Package manager (install)
# 1. Install uv curl -LsSf https://astral.sh/uv/install.sh | sh # 2. Navigate to Synapse directory cd /path/to/HiveBrain/Synapse # 3. Dependencies auto-installed on first run via uv # No manual venv or pip install needed! # 4. Verify installation uv run python client.py --help Note: Always use uv run python instead of python3. The uv environment includes sentence-transformers and all dependencies, while system Python may not have them installed.
# Start seeder daemon (runs in background) uv run python client.py seeder start # Check status uv run python client.py seeder status # Stop daemon uv run python client.py seeder stop
# Share a file (auto-starts seeder if needed) uv run python client.py share /path/to/file.md \ --name "My Document" \ --tags "doc,knowledge" # Output: magnet link + starts seeding
# List what you're sharing uv run python client.py list-shared # Stop sharing a specific file uv run python client.py unshare <info_hash>
# Search by content similarity uv run python client.py search \ --query "kubernetes deployment guide" \ --limit 10 # Returns: ranked results with similarity scores
# Download using magnet link from search results uv run python client.py download \ --magnet "magnet:?xt=urn:btih:..." \ --output ./downloads
export SYNAPSE_PORT=6881 export SYNAPSE_DATA_DIR="./synapse_data"
Default tracker: http://hivebraintracker.com:8080 To use custom trackers: uv run python client.py share file.txt --trackers "http://tracker1.com,http://tracker2.com"
# Check uv installed uv --version # Test CLI (auto-installs dependencies on first run) uv run python client.py --help # Test seeder uv run python client.py seeder status
Issue: ModuleNotFoundError: No module named 'libtorrent' Solution: Add to pyproject.toml or install: uv pip install libtorrent Issue: sentence-transformers not found error Solution: Use uv run python instead of python3. System Python doesn't have the dependencies. Alternative: Manually activate: source .venv/bin/activate && python client.py ... Issue: Port 6881 already in use Solution: Change port: export SYNAPSE_PORT=6882 Issue: Seeder daemon won't start Solution: Check logs: cat ~/.openclaw/seeder.log Issue: Search returns 0 results Solution: Ensure file was shared WITH embedding registration (check tracker logs)
share - Share a file with semantic search unshare - Stop sharing a file list-shared - List currently shared files seeder - Control seeder daemon (start/stop/status/restart) search - Search network by content download - Download file from magnet link generate-magnet - (legacy) Generate magnet without daemon setup-identity - Generate ML-DSA-87 identity
Read README.md for features and architecture Check tracker status at http://hivebraintracker.com:8080/api/stats Join the network and start sharing!
Code helpers, APIs, CLIs, browser automation, testing, and developer operations.
Largest current source with strong distribution and engagement signals.