Contemplative Agent
Local-LLM agent that posts autonomously and proposes revisions to its prompt harness for human approval.
Tested on macOS and Linux
Use it
macOS arm64
You need first
- Runtimes:
Python 3.11+ - At least 16 GB of RAM
- Needs the network
- Keys or accounts: Moltbook API key
git clone contemplative-agent repo
git clone https://github.com/shimo4228/contemplative-agent.git /tmp/ca-verifyuv pip install -e . editable install
cd /tmp/ca-verify && uv venv .venv && uv pip install -e .
Check that it works
/tmp/ca-verify/.venv/bin/contemplative-agent --versionThe output should contain “contemplative-agent 2.14.0”.
First thing to try
MOLTBOOK_HOME=/tmp/ca-test-verify /tmp/ca-verify/.venv/bin/contemplative-agent initRun contemplative-agent init first to set up the agent's home folder.
Linux x86_64
You need first
- Runtimes:
Python 3.11+ - At least 16 GB of RAM
- Needs the network
- Keys or accounts: Moltbook API key
Clone repository checkout
rm -rf /tmp/ca-src && git clone --depth 1 https://github.com/shimo4228/contemplative-agent.git /tmp/ca-srcEditable pip install from checkout
cd /tmp/ca-src && pip install -e . --break-system-packages
Where the README and reality differ
- README: uv pip install -e . (assumes current dir is the clone)
What worked: git clone https://github.com/shimo4228/contemplative-agent.git first (to /tmp/ca-src), then run pip install -e . inside the checkout
Check that it works
contemplative-agent --helpThe output should contain “dialogue”.
First thing to try
MOLTBOOK_HOME=/tmp/ca-a contemplative-agent initRun contemplative-agent init first to set up the agent's home folder.
What it does
- Post on Moltbook on its own using a local LLMNot tested
- Propose changes to its constitution, identity and skillsNot tested
- Turn the episode log into patternsNot tested
How far pickfit got
macOS arm64
- Installs
- Starts
- 0 of 3 features work
- Works offline
Linux x86_64
- Installs
- Starts
- 0 of 3 features work
- Works offline
Other systems
Good for
- post and reply on Moltbook using a local LLM
- propose changes to constitution, identity and skills
- run two agents with different constitutions talking through local pipes
How pickfit tested it
Each run starts from a clean machine and follows the steps above. How pickfit verifies
macOS arm64
Its main function works
- Replayed from scratch
- Works offline
- Checked on 1 Nov 2026
- Version 2.14.0
Linux x86_64
Its main function works
- Replayed from scratch
- Works offline
- Checked on 30 Oct 2026
- Version 2.13.0