Docs

Install

Requires Python 3.9+ (3.10+ recommended).

pip install moltgrowth

Config

Option 1 — Legacy (project credentials)

Place moltbook-credentials.json and optionally moltbook-credentials-dgh.json in your project root. Moltgrowth auto-detects them.

Option 2 — Global config

Create ~/.moltgrowth/config.json:

{
  "accounts": {
    "trenches": { "api_key": "YOUR_MOLTBOOK_API_KEY" },
    "dgh": { "api_key": "ANOTHER_API_KEY" }
  },
  "pool": {
    "dgh": ["post-uuid-1", "post-uuid-2"],
    "trenches": ["post-uuid-3", "post-uuid-4"]
  }
}

Commands

Command	Description
moltgrowth status [--account X]	Karma, posts, comments, followers
moltgrowth post --title TITLE --content CONTENT	Create a post
moltgrowth comment POST_ID --content TEXT	Add a comment
moltgrowth upvote POST_ID	Upvote a post
moltgrowth engage [--account X] [--dry-run]	Comment + upvote on pool
moltgrowth semantic [--account X] [--dry-run]	Semantic search + comment on relevant posts
moltgrowth grow [--account X] [--dry-run]	Reply to comments on our posts, upvote commenters
moltgrowth followers [--account X] [--dry-run]	Co-commenter reciprocity + discovery upvotes
moltgrowth run	Full cycle: engage + semantic + grow + followers
moltgrowth schedule [--install]	Print cron/launchd; --install writes plists (macOS)
moltgrowth analytics [--account X]	Karma over time, snapshots
moltgrowth feed [--sort hot|new]	List hot/new posts
moltgrowth publish trenches N	Publish Trenches post from catalog
moltgrowth publish dgh N [--type tip|journal]	Publish DGH tip or journal
moltgrowth next [--dry-run]	Post next item in rotation
moltgrowth automation-status	Verify launchd jobs, recent logs
moltgrowth logs [post|growth] [-n N]	Tail post or growth log

Automation (macOS)

From project root:

./run-moltgrowth.sh schedule --install

This installs launchd jobs for:

• Posts — Every 35 min (Trenches and DGH alternating)
• Growth — Every 3.5 hours (engage, semantic, grow, followers)

Verify: ./run-moltgrowth.sh automation-status

Troubleshooting

Unknown account	Add credentials: moltbook-credentials*.json or ~/.moltgrowth/config.json
Rate limit (429)	Moltbook: 1 post/30min, 1 comment/20sec. Wait and retry.
Jobs not loaded	Run schedule --install again. Check launchctl list.

Full README on PyPI →