An automated, self-hosted Bot & Dashboard for the Spond app.
Tired of missing out on high-demand group events because they fill up in seconds? SpondBot connects to your Spond account and automatically RSVPs "Yes" to specific events the moment they are created.
Originally a simple cron-script, SpondBot is now a fully-fledged platform featuring:
- 👮 Multi-User Support: Host your own instance and let multiple users configure their own RSVP settings.
- 🎨 Modern Web Dashboard: A sleek, dark-themed "Midnight Violet" UI to manage your RSVPs, monitor status, and link your Spond account.
- ⚡ Background Automation: Fully containerized schedule-driven worker that strictly adheres to your configured limits.
- 🔒 Secure & Private: Hosted entirely on your own hardware. Your Spond credentials are systematically encrypted.
- Phone & Email Authentication: Automatically detects whether an account uses an email or phone number.
- Zero-Trust Hardened: All stored credentials are encrypted with a Fernet symmetric key.
- Admin Management Portal: Built-in Admin dashboard to manage users, reset passwords, and oversee system health.
- Automated Deployments: Quick-start configured with Docker &
docker-compose.
SpondBot is incredibly easy to deploy using Docker. You can host this on your local PC, a Raspberry Pi, or a VPS server.
- Docker & Docker Compose installed on your machine.
- Git (optional, but recommended).
Clone this repository (or download it as a ZIP):
git clone https://github.com/kargfel/spond-bot.git
cd spond-botCreate your environment configuration:
cp .env.example .envOpen .env in your favorite text editor to configure the secrets:
DB_PASSWORD: Set a strong database password.FERNET_KEY: Generate this securely (runpython3 -c "from cryptography.fernet import Fernet; print(Fernet.generate_key().decode())").API_KEY: Set a strong random token.ADMIN_PASSWORD: Set your initial administrator password to access the Web UI.
docker compose up -d --buildThat's it! SpondBot is now running in the background.
Open your web browser and navigate to:
👉 http://localhost:8080 (or your server's IP address)
Log in with:
- Username:
admin - Password: (What you set for
ADMIN_PASSWORD)
From there, you can link your Spond account and start automating your RSVPs!
If you want to expose SpondBot to the open internet (e.g., using a Reverse Proxy like Traefik on a dedicated JumpHost), please read our comprehensive Advanced Deployment Guide.
If you run into issues, have feature requests, or want to contribute:
- Open an Issue in the Issue Tracker.
- Fork the repository and open a Pull Request.
This project is generously provided under the MIT Open Source License.