Stormfire Discord Bot

A Discord bot that lets developers manage their Stormfire AI API gateway account directly from Discord.

What it does

Slash command	What it does
/balance	Show your Stormfire USDT balance
/topup <amount>	Generate a NOWPayments USDT top-up invoice (returns address + QR)
/usage [days]	Show last N days of API usage (cost + token count per model)
/key new <name>	Create a new API key with optional spending limit
/key list	List your active API keys (masked)
/key revoke <id>	Revoke an API key
/models	List supported AI models with current pricing
/help	Show all commands

Why a Discord bot?

Most of Stormfire's target audience already lives in Discord — agent builder communities, indie devs in r/LocalLLaMA's Discord, crypto traders. A Discord bot removes the context-switch tax of opening a browser.

Quick install (server admins)

1. Click the Add to Discord button
2. Pick the server you want to add the bot to
3. Approve the permissions (read messages, slash commands, embed links)
4. Run /help in any channel to verify it works
5. Members will be DM'd a link to authenticate their Stormfire account

Self-host

git clone https://github.com/stormfire-io/stormfire-discord-bot
cd stormfire-discord-bot
cp .env.example .env
# Fill in DISCORD_TOKEN, DISCORD_APP_ID, STORMFIRE_API_KEY
npm install
npm run register-commands  # one-time slash command registration
npm start

Architecture

Discord User
    ↓ /balance
Discord Gateway
    ↓ interaction
Stormfire Bot (Node.js)
    ↓ HTTPS
api.stormfire.io
    ↓
NewAPI backend

Each Discord user is mapped to a Stormfire account via OAuth on first use. No Stormfire credentials are ever stored in Discord.

Privacy

• We store: Discord user ID ↔ Stormfire user ID mapping
• We do NOT store: message content, server names, voice data, anything else
• Source code is fully open — verify yourself

Roadmap

• Repo bootstrap
• Slash command implementations (in progress)
• OAuth flow for first-use authentication
• Public bot install page
• Approval from Discord (verified bot status, ~1500 servers required)

Contributing

PRs welcome. See CONTRIBUTING.md (coming soon).

License

MIT — see LICENSE