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.96.tar.gz (47.7 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.96-py3-none-any.whl (44.4 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: bee2bee-3.6.96.tar.gz
  • Upload date:
  • Size: 47.7 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.96.tar.gz
Algorithm Hash digest
SHA256 88d7fc0dcd9ffa11f9ea9de285c97a746b84319966b4bb40cc03693bbf7a9df2
MD5 a650cdd0858d60ea04515eda36df44a0
BLAKE2b-256 faeb2c10085b9f06711e9b78fc280ffa84468947ebcca36c8338dd462beec060

See more details on using hashes here.

File details

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

File metadata

  • Download URL: bee2bee-3.6.96-py3-none-any.whl
  • Upload date:
  • Size: 44.4 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.96-py3-none-any.whl
Algorithm Hash digest
SHA256 c377df2d5cb0bb8c59ad8ee30460a06ab73881d6730a3a2c8d5874f8a0efb501
MD5 73062aa22160a8f204896574427139c9
BLAKE2b-256 98649719e4027863b8378ad9df05613615efcedc08bbd0b1060cf68f58c0349e

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