Skip to main content

Decentralized P2P network for AI model hosting and inference

Project description

🐝 Bee2Bee: The Global Neural Consensus Mesh

PyPI version License: MIT

Bee2Bee is a decentralized, peer-to-peer neural consensus engine and Web SaaS designed to make AI inference accessible, transparent, and resilient. Contribute compute to a global mesh or consume it via our unified Web UI.


🌐 Connecting to CoitHub.org (The Global Dashboard)

Bee2Bee integrates directly with coithub.org. You do not need to build any front-end to join or use the global mesh.

  1. Host a Node: Run one of the bee2bee serve-* commands (see below).
  2. Access the Mesh: Open coithub.org and click Enter Global Mesh.
  3. Dynamic Registration: You can actively register and expose your API node on CoitHub using the dynamic system registration deep-link format ?link=... to sync your status with the platform in real-time. Ensure your FastAPI port (default 8000) is accessible to traffic.

🛠️ CLI Commands & Examples

Install the package utilizing pip:

pip install bee2bee

(Note: You can run commands via python -m bee2bee or bee2bee if the entrypoint is configured in your OS.)

1. serve-ollama

Serve a fast, local Ollama model directly to the global peer mesh. Includes a built-in FastAPI proxy sidecar for metric telemetry.

Full Usage: python -m bee2bee serve-ollama --model <model> --host <ip> --port <port> --public-host <ip> --region <region> --api-port <port>

Example: Launch a gemma3:270m node exposing telemetry on port 3333:

python -m bee2bee serve-ollama --model gemma3:270m --api-port 3333 --region europe-central

2. serve-hf

Host open-source weights locally via CPU/GPU directly from the Hugging Face hub.

Full Usage: python -m bee2bee serve-hf --model <model> --port <port> --region <region> --api-port <port>

Example:

python -m bee2bee serve-hf --model distilgpt2 --api-port 4000 --region US-East

3. serve-hf-remote

Don't have hardware? You can serve a node utilizing Hugging Face's serverless Inference API. Your peer acts as a remote tunneling proxy!

Full Usage: python -m bee2bee serve-hf-remote --model <model> --token <hf_token> --region <region> --api-port <port>

Example:

python -m bee2bee serve-hf-remote --model HuggingFaceH4/zephyr-7b-beta --token hf_YOUR_SECRET --api-port 8080 --region Cloud

4. register

Manually prompt the Global Supabase registry to verify and route traffic to your node endpoint directly via a handshake test.

Full Usage: python -m bee2bee register --node-url <url> --network <network> --region <region> --test

Example:

python -m bee2bee register --node-url http://104.198.62.116:3333 --network connectit --region europe-central --test

🤝 Community & Support

Built with ❤️ by Loay Abdelsalam and the ConnectIT Team.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

bee2bee-3.7.2.tar.gz (48.0 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

bee2bee-3.7.2-py3-none-any.whl (44.7 kB view details)

Uploaded Python 3

File details

Details for the file bee2bee-3.7.2.tar.gz.

File metadata

  • Download URL: bee2bee-3.7.2.tar.gz
  • Upload date:
  • Size: 48.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.12.7

File hashes

Hashes for bee2bee-3.7.2.tar.gz
Algorithm Hash digest
SHA256 53013d1e75c93e44fb51b44f3ad69fc1b75a0b6d3bfb1c06a4eaf98485bd7c16
MD5 1eb87424de684f5f6c1d9510ddb8b454
BLAKE2b-256 70d6965b24bb08e82999f06318d399330a72af60bec6272529bdc0db2b654d90

See more details on using hashes here.

File details

Details for the file bee2bee-3.7.2-py3-none-any.whl.

File metadata

  • Download URL: bee2bee-3.7.2-py3-none-any.whl
  • Upload date:
  • Size: 44.7 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.12.7

File hashes

Hashes for bee2bee-3.7.2-py3-none-any.whl
Algorithm Hash digest
SHA256 d2e50b59549edda763819c14382044971901ffd24ed00f17f03e655a53cdfa0e
MD5 3c8af0c477582a78fcbb57e113291f7d
BLAKE2b-256 3d40461672d88c6ae36b132f9e91d3bff0ed272ce428d82b393d91385011019e

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page