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.6.21.tar.gz (46.6 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.6.21-py3-none-any.whl (43.2 kB view details)

Uploaded Python 3

File details

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

File metadata

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

File hashes

Hashes for bee2bee-3.6.21.tar.gz
Algorithm Hash digest
SHA256 f424ce52f97e3de48ed209169666bad3bb4f332ec3b1e4fc4902a1cae6785e83
MD5 5d85d7891164890d5c9b813db3edb9fa
BLAKE2b-256 7ecf3644656f8d9f842a53e9498d32d665d28c12637fc2a64f19c43039a90066

See more details on using hashes here.

File details

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

File metadata

  • Download URL: bee2bee-3.6.21-py3-none-any.whl
  • Upload date:
  • Size: 43.2 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.6.21-py3-none-any.whl
Algorithm Hash digest
SHA256 ad069ab80e2f1b414f93d6e0cc3e94058da6c001332d35e45fd821c62cd5a187
MD5 83f43b21962c4f6d1b9fe4bd2281bd43
BLAKE2b-256 dfdce61c151ac07a1a93b48f5e4db0bb2c151e75f8cf75271654d804de18dcf8

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