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.5.17.tar.gz (46.3 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.5.17-py3-none-any.whl (43.0 kB view details)

Uploaded Python 3

File details

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

File metadata

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

File hashes

Hashes for bee2bee-3.5.17.tar.gz
Algorithm Hash digest
SHA256 c271fc362ddbaf29966e0d6493d017b808dca0489c3b99f4e29f3df6986a3844
MD5 fccddf9433123661db0537c723457660
BLAKE2b-256 7e8ff5e9c285a9cb4736ddc98e02f86831fe228ad4deb55e4fdbafafcb3494e5

See more details on using hashes here.

File details

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

File metadata

  • Download URL: bee2bee-3.5.17-py3-none-any.whl
  • Upload date:
  • Size: 43.0 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.5.17-py3-none-any.whl
Algorithm Hash digest
SHA256 9799bf633061a37ec54c5bd5e3e6160790e659f39547e3de3c1ee60bf7b54ef3
MD5 0df5a2d33a3f04b5e465b610e2752fe5
BLAKE2b-256 e919a40c42a17d2417ab0c69f00299cadf99fe282d24896de05a2d8b3d83fe32

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