Welcome to Zirelia Docs 🧜♀️
Zirelia is an advanced, autonomous Virtual Influencer Engine capable of generating its own personality, visual identity, and social media content.
It combines LLMs (OpenAI/Anthropic) for the "Brain", Image Diffusion Models (FLUX.1/SDXL) for the "Imagination", and Social APIs for the "Hands", all wrapped in a Dockerized architecture that runs 24/7 on edge devices like a Raspberry Pi.
📍 Current Tech Stack (as of 2026-02-20)
| Component | Technology | Status |
|---|---|---|
| 🐦 Social Platform | Twitter / X only | ✅ Production Ready |
| 🎨 Image Generation | FLUX 1 via Replicate (remote API) | ✅ Production Ready |
| 🧠 LLM Brain | OpenAI ChatGPT (GPT-4 / GPT-4o-mini) | ✅ Production Ready |
| 📸 Instagram / Others | Not implemented | 🔴 Planned — Phase 4 |
| 🖥️ Control Dashboard | Not implemented | 🔴 Planned — Phase 3 |
[!CAUTION] New account? Read the Warm-Up guide first! Starting the bot on a new account without any credibility baseline is the #1 cause of permanent shadowbans. Read the full guide before doing anything else. → Account Warm-Up & Anti-Ban Guide
🚀 Key Features
- 🧠 Persona Engine: A LangChain-based brain that maintains a consistent personality, memories, and writing style defined in a simple YAML config.
- 🎨 Hyper-Realistic Visuals: Integrates with Replicate to generate consistent character images using custom LoRA models (e.g., Sienna Fox).
- 🤳 Autonomous Posting: A Smart Scheduler that randomizes posting times (Morning, Afternoon, Evening) and respects holidays/events.
- 🔌 Easy Deployment: Fully Dockerized stack (API, Worker, Scheduler, Redis, Postgres) ready for
docker compose up. - 🛡️ Visual QC: AI-powered image critic that rejects anatomical hallucinations before posting.
📚 Documentation Structure
- ⚠️ Account Warm-Up & Anti-Ban: Read this first. How to onboard a new account safely.
- Getting Started: Set up the engine on your local machine or server.
- Core Architecture: Understand how the Brain, Imagination, and Hands work together.
- Guides: Learn how to train your own LoRA face model and create synthetic datasets.
- API Reference: Technical details for developers.
- Roadmap: What's next.
- ⚖️ Legal Disclaimer: Terms of use, liability limits, and compliance notes.
[!WARNING] Zirelia is provided "as-is" for educational purposes. The developers take no responsibility for account bans, API costs, or any consequences of using this software. See Legal Disclaimer.
Built with ❤️ by Antonio Trento.