generate_sassy_responseLABSCO SUMMARY
The tone decision is the product.
Anyone can generate a rebuttal; the useful part is the filter in front of it, which routes grief and illness to a gentle answer and conspiracy material to a refusal, so the sharp voice only fires where it belongs. Demo mode is on by default, so you can read what it writes before any account is involved.
What it is
A response-generation server for fact-checking in social messages. It classifies the incoming claim, picks a tone, and writes a short reply with a source attached. Sending the message is a separate Instagram server's job; this one writes what gets sent.
What you get
- A short fact-check reply with a citation and a deliberate voice, sized for a direct message (generate_sassy_response)
- Tone chosen automatically from the content: sharp for health myths, gentle for grief and illness, plain for professional contexts, and a polite refusal for conspiracy material
- A welcome message written for a new follower (generate_welcome_message)
- Practice claims to work against without connecting a real account, in the demo mode that is on by default (check_instagram_dms)
- A status readout showing whether the messaging side is actually wired up (instagram_integration_status)
- Interaction logging, for daily counts
Requirements
An Anthropic API key. Demo mode needs nothing else. For live use you also run the separate Instagram messaging server and supply account credentials — and the project advises a dedicated throwaway account, since Instagram restricts accounts it detects as automated. Python, in a virtual environment.
Setup effort
Build from source — git clone https://github.com/sangreal-007/sassy-factcheck-bot.git
USE CASES
01
Answering a viral health claim
Hand it the claim and get a short reply with a source, sized for a message.
02
Not being flippant about the wrong message
Sensitive subjects are detected and answered gently instead, without you flagging them first.
03
Trying it before connecting an account
Work against the practice claims in demo mode.
04
Greeting new followers
Generate a welcome message rather than writing the same one repeatedly.
05
Checking the wiring
Read the integration status to see whether the messaging side is actually connected.
4 tools
Listed in project docs. Your client may show a different list.
generate_welcome_messagecheck_instagram_dmsinstagram_integration_statusBEFORE YOU INSTALL
What to know first
Tools you get
4 tools named in the project's documentation.
Requires
- Python 3.11+
- ANTHROPIC_API_KEY in your environment
Optional
- INSTAGRAM_PASSWORD in your environment
- INSTAGRAM_USERNAME in your environment
Where it runs
The documented client runs the server on your machine.
INSTALLATION
Connect your client
Server setup
TERMINAL
git clone https://github.com/sangreal-007/sassy-factcheck-bot.git
cd sassy-factcheck-bot
# Create and activate virtual environment (required on macOS)
python3 -m venv venv
source venv/bin/activate
# You should see (venv) in your terminal prompt
# Interactive credential setup
python setup_env.py
# Install dependencies
pip install -r requirements.txt
MCP Clients
Claude Desktop
CLAUDE DESKTOP · JSON
{
"mcpServers": {
"sassy_factcheck": {
"command": "/Users/<YOUR_USERNAME>/sassy-factcheck-bot/venv/bin/python",
"args": [
"/Users/<YOUR_USERNAME>/sassy-factcheck-bot/src/mcp_server.py"
],
"cwd": "/Users/<YOUR_USERNAME>/sassy-factcheck-bot"
}
}
}/Users/<YOUR_USERNAME>/ is the path pwd prints in your clone. Demo mode needs only this server. Real mode also needs the separate Instagram DM MCP server (github.com/trypeggy/instagram_dm_mcp, included as the repository's submodule) registered beside it.
python setup_env.py writes the .env for you: ANTHROPIC_API_KEY always, and INSTAGRAM_USERNAME and INSTAGRAM_PASSWORD only if you pick real mode.
