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.27.tar.gz (46.9 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.27-py3-none-any.whl (43.6 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: bee2bee-3.6.27.tar.gz
  • Upload date:
  • Size: 46.9 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.27.tar.gz
Algorithm Hash digest
SHA256 c76a086eec14c2920429feb285305e51cfb5f93dca2630d9d1815fa16d140d73
MD5 674c3377bf208ceec49bf166ab42fc91
BLAKE2b-256 11b5a4274067d749bd7dc8e7a3e5c1d796dd1de25a871b7fb7e3c4a47950846d

See more details on using hashes here.

File details

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

File metadata

  • Download URL: bee2bee-3.6.27-py3-none-any.whl
  • Upload date:
  • Size: 43.6 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.27-py3-none-any.whl
Algorithm Hash digest
SHA256 2a814836a6627c92c78ebd95d65946e5ead50dcf7c7984971455ba5566318d0c
MD5 6e4587e6248514a411c152a7fdcd66d7
BLAKE2b-256 ffb629776834a6a66ec051a092b89d1fe6780d168ec5cd3a62fa76cda92dfd01

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