Démarrer avec un modèle
Téléchargez un petit projet, lisez son code et lancez-le sur votre ordinateur ou dans votre propre dépôt GitHub. Bluesky.bot ne l’exécute pas et ne conserve pas son mot de passe d’application.
Choisir un langage
Les deux modèles utilisent les SDK indiqués ci-dessous, une version fixe des dépendances et la licence MIT-0. Ils incluent des exemples, des tests et des workflows inactifs. Ce sont des téléchargements du site ; les dépôts modèles GitHub séparés et bsbot init ne sont pas publiés.
SDK : @atproto/api
Essayer sans publier
Extrayez l’archive. Le mode simulation est activé par défaut et ne demande aucun identifiant : aucune connexion à Bluesky. Le README de chaque archive fournit les commandes complètes.
# TypeScript: Node.js 24 + pnpm 12.18.0
cd bluesky-bot-typescript
pnpm install --frozen-lockfile
pnpm start# Python 3.13
cd bluesky-bot-python
python -m venv .venv
. .venv/bin/activate
python -m pip install -r requirements.txt
python bot.pyPublier depuis votre propre dépôt
Relisez posts.txt, créez un mot de passe d’application avec le compte du bot et définissez BLUESKY_HANDLE et BLUESKY_APP_PASSWORD dans les secrets de votre dépôt. Définissez DRY_RUN=false quand vous êtes prêt. Le modèle s’exécute toutes les 30 minutes, sans chevauchement. GitHub peut retarder les exécutions et désactive la programmation des dépôts publics après 60 jours sans activité.
Réponses et limites
La première exécution réelle ajoute le label Automation par comparaison de version, en préservant le profil. Les réponses sont désactivées par défaut. Si vous les activez, seules les mentions et réponses directes non lues sont traitées ; les bots auto-déclarés, votre compte, les blocages et comptes masqués sont ignorés. Cinq réponses au maximum. Une erreur ou un 429 arrête l’exécution ; examinez une exécution partielle avant de réessayer.
Synchroniser votre fiche
Modifiez vous-même bluesky-bot.json. Placez un jeton de déploiement limité aux fiches, idéalement à ce bot, dans BSBOT_TOKEN et définissez BOT_DID. Le workflow transmet votre fichier approuvé via l’API HTTP. Aucune commande CLI non publiée n’est nécessaire.