Part of BlackRoad OS — Sovereign Computing for Everyone
pi community uot is part of the BlackRoad OS ecosystem — a sovereign, distributed operating system built on edge computing, local AI, and mesh networking by BlackRoad OS, Inc.
| Org | Focus |
|---|---|
| BlackRoad OS | Core platform |
| BlackRoad OS, Inc. | Corporate |
| BlackRoad AI | AI/ML |
| BlackRoad Hardware | Edge hardware |
| BlackRoad Security | Cybersecurity |
| BlackRoad Quantum | Quantum computing |
| BlackRoad Agents | AI agents |
| BlackRoad Network | Mesh networking |
Website: blackroad.io | Chat: chat.blackroad.io | Search: search.blackroad.io
Discord bot for managing the Pi AI ecosystem community. Welcomes members, tracks stats, celebrates milestones, and coordinates the revolution!
Manage Pi AI Discord communities with:
- Auto-welcome new members with links to resources
- Real-time stats from GitHub, registry, calculator
- Milestone celebrations when repos hit star goals
- Quick commands for common questions
- Automated monitoring every 15 minutes
Automatically greets new members with:
- Links to starter kit, calculator, registry
- Quick start guide
- Community guidelines
Prefix: !pi
!pi stats- Show ecosystem statistics!pi calculator- Link to cost calculator!pi install- Installation instructions!pi register- Join the global registry!pi compare- NVIDIA vs Pi comparison!pi repos- List all repositories!pi help- Show available commands
Automatically announces when repos hit:
- 🎯 10 stars - First milestone
- ✨ 25 stars - Growing
- 🚀 50 stars - Momentum
- 🎉 100 stars - Major
- 🌟 250 stars - Trending
- 🏆 500 stars - Viral
- 🔥 1,000 stars - Legendary
Every 15 minutes:
- Fetches latest GitHub stats
- Updates internal cache
- Checks for new milestones
- Announces achievements
- Go to Discord Developer Portal
- Click "New Application"
- Give it a name: "Pi AI Bot"
- Go to "Bot" section
- Click "Add Bot"
- Copy the bot token (you'll need this later)
Generate invite URL:
https://discord.com/api/oauth2/authorize?client_id=YOUR_CLIENT_ID&permissions=8&scope=bot
Replace YOUR_CLIENT_ID with your bot's client ID from Developer Portal.
Permissions needed:
- Read Messages
- Send Messages
- Embed Links
- Manage Messages
- Read Message History
# Clone the repo
git clone https://github.com/BlackRoad-OS/pi-community-bot.git
cd pi-community-bot
# Run setup
chmod +x setup.sh run.sh
./setup.sh
# Edit .env with your bot token
nano .env # or vim .env
# Run the bot
./run.sh# Create virtual environment
python3 -m venv venv
source venv/bin/activate
# Install packages
pip install -r requirements.txtCreate .env file:
DISCORD_BOT_TOKEN=your_discord_bot_token_here# Make scripts executable
chmod +x run.sh
# Start bot
./run.shFor best results, create these channels:
- #welcome - Bot sends welcome messages here
- #announcements - Milestone announcements
- #general - Fallback for announcements
- #support - Help & questions
- #showcase - Community Pi setups
- #success-stories - Real-world deployments
- #off-topic - General chat
- Pi Pioneer - Launched first node
- Pi Champion - 10+ nodes
- Pi Master - 100+ nodes
- Contributor - GitHub contributions
!pi stats
Shows real-time statistics:
- GitHub stars across all repos
- Total forks & watchers
- Active nodes (2,847+)
- Countries (67)
- Total savings ($8.2M)
!pi repos
Lists all repositories with star counts:
- Cost Calculator
- Starter Kit
- Registry
- Hub
- Launch Dashboard
- Monitoring Automation
!pi calculator
Links to interactive cost calculator
Shows 5-year TCO comparison
!pi install
One-command installation guide
Lists what gets installed
Links to full documentation
!pi register
Links to global registry
Shows success stories
Explains how to add your node
!pi compare
Side-by-side NVIDIA vs Pi:
- Cost ($3,000 vs $75)
- Availability (May 2025 vs NOW)
- Power (500W vs 15W)
- CO2 (2.19 tons vs 0)
- Sovereignty (0% vs 100%)
- 5-Year TCO ($6,285 vs $175)
Edit bot.py, function on_member_join():
embed = discord.Embed(
title="🥧 Your Custom Title",
description=f"Custom welcome for {member.mention}!",
color=COLOR_AMBER
)@bot.command(name='mycommand')
async def my_command(ctx):
"""Command description"""
embed = discord.Embed(
title="My Command",
description="Command content",
color=COLOR_BLUE
)
await ctx.send(embed=embed)Edit monitor_github task decorator:
@tasks.loop(minutes=15) # Change to desired interval
async def monitor_github():
# ...Edit check_milestone():
milestones = [10, 25, 50, 100, 250, 500, 1000, 2500, 5000]Uses BlackRoad color palette:
COLOR_AMBER = 0xF5A623 # Primary
COLOR_PINK = 0xFF1D6C # Accents
COLOR_BLUE = 0x2979FF # Links
COLOR_VIOLET = 0x9C27B0 # BordersAll embeds follow consistent styling:
- Bold titles
- Organized fields
- Footer with tagline
- Branded colors
- Fetches stats every 15 minutes
- Caches results to reduce API calls
- Rate limit: 5,000 requests/hour (authenticated)
- pi-cost-calculator
- pi-ai-starter-kit
- pi-ai-registry
- pi-ai-hub
- pi-launch-dashboard
- pi-monitoring-automation
bot.stats_cache = {
'BlackRoad-OS/pi-cost-calculator': {
'stars': 64,
'forks': 18,
'watchers': 32
},
# ... other repos
}- Check bot token in
.env - Verify bot has permissions in server
- Check bot is online in Discord
- View logs for errors
- Ensure command prefix is
!pi(with space) - Check bot has "Read Messages" permission
- Verify channel permissions
- Create
#announcementsor#generalchannel - Give bot "Send Messages" permission
- Check milestone wasn't already announced
- Verify internet connection
- Check GitHub API status
- Review rate limits (5,000/hour)
- ✅ Keep bot token secret (never commit
.env) - ✅ Use minimal required permissions
- ✅ Regularly update dependencies
- ✅ Monitor bot activity logs
# Add to .gitignore
echo ".env" >> .gitignore
echo "venv/" >> .gitignore./run.shCreate /etc/systemd/system/pi-bot.service:
[Unit]
Description=Pi AI Community Bot
After=network.target
[Service]
Type=simple
User=your_user
WorkingDirectory=/path/to/pi-community-bot
ExecStart=/path/to/pi-community-bot/run.sh
Restart=always
[Install]
WantedBy=multi-user.targetEnable & start:
sudo systemctl enable pi-bot
sudo systemctl start pi-bot
sudo systemctl status pi-botCreate Dockerfile:
FROM python:3.11-slim
WORKDIR /app
COPY requirements.txt .
RUN pip install -r requirements.txt
COPY . .
CMD ["python3", "bot.py"]Run:
docker build -t pi-community-bot .
docker run -d --env-file .env --name pi-bot pi-community-bot# Install Railway CLI
npm install -g @railway/cli
# Login
railway login
# Deploy
railway init
railway upAdd DISCORD_BOT_TOKEN in Railway dashboard.
Bot logs to stdout:
🚀 Pi AI Bot is ready!
📊 Connected to 3 servers
👥 Serving 1,247 members
✅ Background tasks started
Add logging in commands:
@bot.command(name='stats')
async def stats(ctx):
print(f"📊 Stats command used by {ctx.author} in {ctx.guild}")
# ... rest of command- Pi Launch Dashboard - Real-time analytics
- Pi Monitoring - GitHub tracking
- Pi Cost Calculator - Savings calculator
- Pi AI Starter Kit - Installation
- Pi AI Registry - Global directory
- Pi AI Hub - Landing page
Contributions welcome! Ideas:
- Reddit integration (track upvotes)
- Twitter integration (track mentions)
- Hacker News integration (track points)
- Calculator usage stats
- Registry node tracking
- Success story showcases
- Weekly summaries
- Leaderboards
Proprietary - BlackRoad OS, Inc.
For non-commercial use only. See LICENSE file.
Same energy. 1% cost. 100% sovereignty.
Built with Claude Code (Anthropic) January 2026
Questions? Join the Discord! Commands list with !pi help