Skip to main content

​
Welcome to Genie Helper

Genie Helper is an AI operations platform designed specifically for adult content creators. It connects to your OnlyFans and other creator platforms, scrapes your stats, classifies your content, drafts fan messages, schedules posts, and answers questions about your performance — all from a private chat interface running on your own server.
Self-hosted. Uncensored. No OpenAI tax.Your data, your server, your sovereignty. The AI agent is powered by locally-running uncensored models. Nothing leaves your VPS.

​
What It Does

Genie Helper automates the operational burden of managing your creator business:

Platform Integration

Connect to OnlyFans and 8 other creator platforms. Automated scraping of stats, content, and engagement metrics.

Content Classification

AI-powered taxonomy system with 3,208 classified tags across 6 super-concepts for intelligent content organization.

Fan Engagement

Draft personalized fan messages and responses. Track fan profiles and engagement data.

Content Scheduling

Schedule posts across multiple platforms. Post scheduler polls every 60 seconds for execution.

Media Processing

Watermark images, generate video teasers, and create thumbnails with ImageMagick and FFmpeg.

Performance Analytics

Ask questions about your performance metrics and get AI-powered insights from your data.

​
Key Features

​
MCP-First Architecture

Genie Helper is built on the Model Context Protocol (MCP) with 29 tools across three MCP servers:
  • Directus MCP (17 tools): CRUD collections, trigger flows, manage users/files
  • Ollama MCP (3 tools): generate, chat, list-models
  • Stagehand MCP (9 tools): browser sessions, navigate, act, extract, cookies, screenshot

​
Action Runner System

The Action Runner intercepts [ACTION:slug:{"params"}] tags from the AI model, strips them from visible chat, executes pre-built flows, and streams status back. No complex tool-calling required. Available Actions:
ActionPurpose
scout-analyzeScrape URL + AI analysis
taxonomy-tagAuto-classify content with 6-concept taxonomy
post-createDraft platform-specific social post
message-generateFan engagement message
memory-recallSearch stored data + summarize
media-processQueue media job (watermark, teaser, compress)

​
Uncensored Local Models

Runs entirely on self-hosted Ollama models:
  • dolphin3:8b-llama3.1 — Orchestrator / tool planning
  • dolphin-mistral:7b — Uncensored content writer / captions
  • qwen-2.5:latest — Primary agent / code / JSON
  • scout-fast-tag:latest — Fast taxonomy classifier
  • bge-m3:latest — Embeddings

​
Enterprise-Grade Security

Platform credentials are encrypted with AES-256-GCM server-side. No encryption keys ever touch the browser.
  • Encrypted credential storage with CREDENTIALS_ENC_KEY_B64
  • Directus JWT authentication with auto-refresh
  • Admin impersonation for support workflows
  • RBAC role synchronization between Directus and AnythingLLM

​
Human-in-the-Loop Browser Automation

When automated login fails, the system creates a HITL session request. You complete the login in your browser extension, and the captured cookies are automatically encrypted and stored for future use.

​
Tech Stack

Genie Helper combines four powerful open-source platforms: 
AnythingLLM     Chat API + agent + embed widget
Directus CMS    Collections, auth, REST API
Ollama          Local LLM inference (port 11434)
Stagehand       Browser automation server

​
Next Steps

1

Quick Start

Follow the Quick Start guide to clone, install, and configure Genie Helper on your server.
2

Architecture Deep Dive

Review the Architecture documentation to understand how services communicate and data flows through the system.
3

Platform Connections

Connect your creator platforms and start automating your workflow.
Development Status: Genie Helper is in active development. Current phase: 9F completed (AgentWidget, MCP schema fixes, cookie-first HITL).

Build docs developers (and LLMs) love

Get started for freeTalk to us