Loopmark

Documentation

Everything you need to install, configure, and run Loopmark, plus how to contribute back.

Getting started

Requires Python 3.10+ and an OpenAI API key.

terminal
git clone https://github.com/loopmark-opensource/loopmark-agent.gitcd loopmark-agentpython3 -m venv .venvsource .venv/bin/activatepip install -r requirements.txtcp .env.example .env

Then set OPENAI_API_KEY in .env and run:

run.py
python3 main.py

Configuration

Only OPENAI_API_KEY is required. Everything else is optional.

Variable
Default
Description
OPENAI_MODEL
gpt-4o
Model to use
OPENAI_TEMPERATURE
0.7
Default temperature
BUFFER_ACCESS_TOKEN
none
Schedule to Twitter, LinkedIn, Instagram, Facebook
TWITTER_API_KEY
none
Post directly to Twitter/X
LINKEDIN_ACCESS_TOKEN
none
Post directly to LinkedIn

Usage

python3 main.pyStart an interactive chat
python3 main.py --verboseShow which sub-agent handled each request
python3 main.py statsView a summary of stored data
python3 scheduler.pyRun the auto-posting scheduler

Project structure

loopmark-agent/
loopmark-agent/├── main.py# Interactive CLI├── scheduler.py# Auto-posting daemon├── agents/│   ├── graph.py# Router + orchestrator│   └── sub_agents.py# Complaints, Posting, Funnel├── tools/│   ├── complaint_tools.py│   ├── social_tools.py│   ├── email_tools.py│   ├── publisher_tools.py│   └── funnel_tools.py└── data/# Auto-created JSON storage

Contributing & git branching

Loopmark is MIT licensed and open to contributions. We use a simple feature-branch workflow.

mainforkfeature/my-changemerged
workflow
git checkout -b feature/my-change# make changes, commit, pushgit push origin feature/my-change
  1. 1
    Fork the repository

    Create your own copy on GitHub.

  2. 2
    Create a feature branch

    git checkout -b feature/my-change

  3. 3
    Make your changes and test locally

    Keep changes focused and match the existing code style.

  4. 4
    Open a pull request

    Describe your change clearly against main.

Troubleshooting

Set OPENAI_API_KEY in your .env file

Copy .env.example to .env and add your real API key.

Twitter posting fails

Twitter write access requires a paid API tier. Use Buffer instead.

Posts not publishing automatically

Make sure the scheduler is running and scheduled_date is today or earlier.