Rejoindre HiveMind La Ruche

1. Utiliser les modèles

1. Créez votre compte avec un pseudonyme de votre choix. Le pseudonyme est public (il peut apparaître dans des listes et sur le bus de messages) : choisissez-en un, de 1 à 64 lettres ASCII, chiffres ou . _ @ + -.

curl -s https://hivemind-openrouter-1003063861791.us-central1.run.app/v1/hivemind/register -H "Content-Type: application/json" -d '{"handle":"your-handle","role":"consumer"}'

2. La réponse contient votre clé d'API (api_key). Elle n'est affichée qu'une fois et ne peut pas être récupérée : gardez-la en lieu sûr. Si vous la perdez, inscrivez un nouveau pseudonyme.
3. Un nouveau compte a 0 point, sauf don de l'opérateur. Les points viennent du partage d'un GPU (voie 2) ou d'un don : si vous voulez seulement essayer, demandez-en un dans un billet GitHub.
4. Testez votre clé :

export HIVEMIND_API_KEY=hm-YOUR_KEY
curl https://hivemind-openrouter-1003063861791.us-central1.run.app/v1/chat/completions \
  -H "Authorization: Bearer $HIVEMIND_API_KEY" -H "Content-Type: application/json" \
  -d '{"model":"hivemind/auto","messages":[{"role":"user","content":"Hello!"}]}'

Dans un éditeur (VS Code, Continue, …), suivez le guide de connexion.

2. Partager votre GPU pour répondre aux questions

Votre ordinateur fait tourner un modèle, la passerelle lui envoie des questions, et vous gagnez des points pour les jetons (tokens) servis. Vous utiliserez un terminal.

1. Obtenez le code (Python 3.11 ou 3.12) :

git clone https://github.com/xaviercallens/HiveMind.git && cd HiveMind
pip install httpx fastapi uvicorn

2. Trouvez le modèle qui convient à votre carte (le tableau plus bas les liste tous). Cette commande lit la mémoire de votre carte et ne demande aucun compte :

python scripts/hivemind_producer_agent.py --gateway https://hivemind-openrouter-1003063861791.us-central1.run.app --suggest --detect-vram

3. Installez Ollama, puis téléchargez le modèle suggéré, par exemple :

ollama pull qwen2.5-coder:3b

4. Créez un compte producteur de la même façon, avec "role":"producer" (ou "prosumer" si vous voulez aussi utiliser les modèles), et gardez la clé.

5. Votre ordinateur doit être joignable en https à une adresse publique : la passerelle refuse le http simple et les adresses privées. À la maison, cela veut dire un tunnel ou un mandataire inverse devant le « shield » du producteur, un petit programme qui n'expose que les deux routes dont la passerelle a besoin et exige son jeton. Vérifiez avec curl https://VOTRE_POINT/v1/models.
6. Démarrez le shield et l'agent (toutes les options : le guide du producteur). Utilisez d'abord --once pour voir la réponse de la passerelle :

export HIVEMIND_API_KEY=hm-YOUR_PRODUCER_KEY
export HIVEMIND_ENDPOINT_TOKEN="$(python -c 'import secrets;print(secrets.token_urlsafe(32))')"
python scripts/hivemind_producer_shield.py --upstream http://127.0.0.1:11434 --port 8787 --allow-model qwen2.5-coder:3b &
python scripts/hivemind_producer_agent.py --gateway https://hivemind-openrouter-1003063861791.us-central1.run.app --endpoint https://YOUR_ENDPOINT --preset coder-lite --once

Sous Windows (PowerShell), définissez les variables avec $env:NOM="valeur" au lieu de export. Retirez --once pour laisser l'agent en marche.

Vous pouvez arrêter en tout temps : après environ deux minutes sans signal de vie, la passerelle cesse de vous envoyer des requêtes.

3. Entraîner des modèles la nuit avec BOINC

Cette voie est ouverte au public : le coordinateur fédéré BOINC et Night-MoE est en ligne sur HiveMind La Ruche (télémétrie Night-MoE en direct sur /night-moe et classement de science participative sur /community). Vous pouvez vérifier votre matériel et calculer des unités dès aujourd'hui.

• Linux sur processeur x86-64 pour l'archive BOINC native, ou Linux, Windows et macOS avec l'agent Python BOINC/BLS
• Une carte NVIDIA avec au moins 3,5 Go de mémoire vidéo
• Un premier téléchargement d'environ 4,4 Go, réutilisé ensuite
• Le travail communautaire est offert la nuit, de 22 h à 7 h, heure de Paris, quand le réseau est le moins occupé
• Le client BOINC standard; les fichiers du projet sont signés numériquement

1. Lancez d'abord la vérification matérielle en lecture seule (elle n'installe rien et n'envoie rien) :

python3 scripts/hivemind_volunteer_preflight.py

2. Louez et calculez une unité de travail BOINC fédérée en direct (physics_sim, code_generation ou math_reasoning) depuis le coordinateur public (retirez --once pour continuer le calcul la nuit) :

python3 scripts/hivemind_boinc_idle_worker.py --coordinator https://hivemind-at-home-ruche-cfhmhmvv5a-uc.a.run.app --handle your-handle --domain physics_sim --once

4. Joueurs et Steam

Votre GPU ne calcule des unités d'astrophysique et d'IA que lorsque vous ne jouez pas. L'édition Steam gratuite (USS HiveMind NCC-31337: Astrophysics Exoplanet Hunter, Steam AppID 3133700) et l'agent de pause GPU automatique sont disponibles dès aujourd'hui, réunissant joueurs et scientifiques citoyens sur le portail communautaire en direct.

Pendant que vous jouez (inactivité < 4 s au clavier/souris ou charge GPU supérieure à 45 %), le calcul GPU BOINC se met en pause automatiquement (boinccmd --set_gpu_mode never, 0 % de surcharge GPU) pour laisser 100 % de votre carte graphique au jeu à 60 FPS. Après 4 secondes d'inactivité (avec une charge GPU inférieure à 45 % et une température inférieure à 78 °C), il reprend automatiquement le pliage des transits d'exoplanètes TESS/JWST.

1. Démarrez l'agent de pause GPU automatique (retirez --once pour laisser le démon de pause/reprise automatique tourner en arrière-plan pendant vos sessions de jeu) :

python3 scripts/hivemind_boinc_idle_worker.py --coordinator https://hivemind-at-home-ruche-cfhmhmvv5a-uc.a.run.app --handle your-handle --idle-threshold-seconds 4 --once

2. Vous pouvez aussi déclencher une pause ou une reprise GPU immédiate depuis une option de lancement Steam :

python3 scripts/hivemind_boinc_idle_worker.py --pause-now

3. Si vous faites aussi tourner un producteur Ollama de la voie 2, un modèle de langue chargé garde sa mémoire vidéo même quand personne ne pose de question ; avant de lancer un jeu gourmand, arrêtez l'agent producteur (Ctrl+C) et libérez la mémoire (remplacez le nom par celui de votre modèle) :

ollama stop qwen2.5-coder:3b

4. Après avoir joué : redémarrez l'agent producteur, avec la même commande qu'à la voie 2 (l'agent BOINC GPU inactif reprend de lui-même).

Bon à savoir

• Les producteurs voient les questions qui leur sont envoyées. N'exploitez pas un producteur sur une machine qui contient des secrets, et n'envoyez pas de texte confidentiel au réseau.
• Les points n'ont aucune valeur monétaire et ne sont pas un paiement.
• Le partage consomme de l'électricité pendant que votre GPU répond. Mesurez votre carte avec nvidia-smi --query-gpu=power.draw --format=csv et multipliez par les heures de travail.
• Le logiciel est libre (AGPL-3.0). Lisez le code avant de l'exécuter.
• Le réseau est jeune et exploité par des bénévoles : la disponibilité n'est pas garantie.

Questions et aide

Ouvrez un billet sur GitHub, en français ou en anglais. Pour un problème de sécurité, lisez d'abord la politique de sécurité.