🚀 Moltbook Auto-Minter GUI

🇬🇧 English • 🇵🇱 Polski

Windows EXE Linux-DEB Raspberry%20Pi

Latest version: v0.1.7 – background MBC20 daemon, shared settings & logs, automatic indexing, and optional Windows auto‐start installer

A user-friendly desktop application for creating and auto-minting
MBC-20 inscriptions on Moltbook,

with integrated AI puzzle solving (lobster + LLM), fully separated LLM control for Main and Auto-Mint,
default pure LLM workflow, enhanced bilingual UI (EN/PL), dynamic form visibility on startup,
structured multi-key .env editor, improved logging with status bar,
automatic Moltbook retry handling, mbc20.xyz indexer support,
and a configurable MBC20 daemon that runs auto-mint in the background using shared profiles and settings.

If you want Auto-Mint to run continuously in the background on Raspberry Pi (headless supported), you can install the optional MBC20 daemon as a system service.

• Uses the same shared files as the main GUI: mbc20_profiles.json, mbc20_daemon_settings.json, mbc20_history.log
• Runs fully in the background (SSH compatible, no desktop required)
• Each Auto-Mint folder creates its own service instance (e.g. Daemon1, Daemon2)

Download the installer script into your target folder and run it.

See full installation and usage instructions in daemonRPi.md .

If you want Auto-Mint to run 24/7 on standard Linux or on older Raspberry Pi OS / Raspbian versions, you can use the same MBC20 daemon script as a background service.

• Supports Debian / Ubuntu / MX Linux (systemd or SysVinit) and older Raspbian releases (Jessie, Stretch, Buster, Bullseye, Bookworm)
• Shares profiles, settings and history with the main GUI: mbc20_profiles.json, mbc20_daemon_settings.json, mbc20_history.log
• Automatically installs dependencies and registers the service for background auto-minting

Download the installer script into your target folder and run it.

See full installation and usage instructions in LinuxDaemonRPiOld.md .

If you want Auto-Mint to run continuously in the background, including after system reboots, you can install the optional MBC20 daemon.

• The daemon uses the same shared files as the main GUI:
  • mbc20_profiles.json, mbc20_daemon_settings.json, mbc20_history.log.
• A dedicated daemon GUI allows configuration of:
  • token profile, first_start_minutes, base_interval_minutes,
  • Moltbook 5xx retry interval and fixed backoff for other errors,
  • language selection and the "Start daemon at startup" option.
• An interactive PowerShell installer can:
  • download all daemon Python files into your project directory,
  • optionally install dependencies from requirements.txt,
  • create a MBC20 Daemon GUI shortcut and add it to Windows auto-start.

See full installation and usage instructions in deamon.md .

• 🖥️ Modern PyQt6 GUI (PyQt5 on RPi) -- Tabs: Main, History, .env Editor, Auto Mint
• 🧠 AI Brain Integration -- Automatically solves Moltbook lobster puzzles using OpenAI
• 🔄 Auto-Mint Scheduler -- Configurable intervals, smart backoff, max runs control
• 📜 History Log Viewer -- Track posts and bulk re-index via mbc20.xyz API
• 🌍 Language Switcher -- English / Polish interface
• 🔐 Built-in .env Editor -- Manage API keys directly inside the app

• Python 3.10+ (recommended)
• Git
• Windows, Linux or macOS

• requests
• python-dotenv
• PyQt6
• psutil

Install them via:

pip install -r requirements.txt

git clone https://github.com/hattimon/auto-minter-gui.git
cd auto-minter-gui

Copy example configuration:

cp .env.example .env

Edit .env and add:

MOLTBOOK_API_KEY=your_moltbook_api_key_here
OPENAI_API_KEY=your_openai_key_here
OPENAI_MODEL=gpt-4.1-mini

• MOLTBOOK_API_KEY -- Required for Moltbook posting & verification
• OPENAI_API_KEY -- Used for lobster puzzle solving
• OPENAI_MODEL -- Defaults to gpt-4.1-mini if not specified

Create OpenAI key:
https://platform.openai.com/api-keys

python -m venv .venv
.\.venv\Scripts\activate
pip install -r requirements.txt
python main.py

Make sure Python is added to PATH.

python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
python main.py

On some Linux distributions, additional Qt runtime libraries may be required.

• Create deploy / mint / transfer / link operations
• Randomize title
• Save and load token profiles
• Auto-verify posts with AI puzzle solver

• Test OpenAI integration
• View expected vs actual lobster puzzle answers

• View mbc20_history.log
• Bulk re-index posts
• Skip indexed or errored entries

• Reload and edit environment configuration
• Instantly update API keys

• Configure minting intervals
• Smart exponential backoff on errors
• Infinite or limited run modes
• Background worker thread execution

Main window

Main window menu

Auto Mint tab

History tab

.env editor

👉 Open builds.md

1. Fork the repository
2. Create feature branch
3. Commit changes
4. Push branch
5. Open Pull Request

Ideas, improvements and feature suggestions are welcome!

For Polish documentation see:

➡️ README_PL.md