🚀 Install in One Command

pip install hypermotion

Requires Python 3.10+. A virtual environment is strongly recommended.

⚙️ Quick Start

1 — Install

pip install hypermotion

2 — Initialize a fresh workspace

# Creates .env template + empty data/output dirs — nothing from anyone else
hypermotion init

Or into a specific folder:

hypermotion init ./my-hypermotion
cd my-hypermotion

3 — Add your API keys

Edit the generated .env file:

# Minimum required — pick at least one LLM provider
GEMINI_API_KEY=your-gemini-key-here

# Optional extras (adds fallback & image generation)
OPENAI_API_KEY=
OPENROUTER_API_KEY=

# Facebook Growth Engine (sandbox mode works without these)
FACEBOOK_PAGE_ID=
FACEBOOK_PAGE_ACCESS_TOKEN=

🔒 .env is listed in .gitignore — it is never committed or shared.

4 — Start the server

hypermotion start

Open http://localhost:8500 — Mission Control loads instantly.

🧩 CLI Reference

🛡️ Fresh Install Guarantee

Every hypermotion init creates:

your-project/
├── .env                ← YOUR keys only (generated from template)
├── .gitignore          ← Secrets & output excluded automatically
├── data/               ← Empty — YOUR runtime DB only
├── output/             ← Empty — YOUR generated media only
│   ├── facebook_media/
│   └── quizzes/
├── .cache/             ← Empty — YOUR cache only
└── config/             ← Empty — YOUR YAML config only

No API keys, images, databases, or any data from other users is ever included.

🔋 What's Inside

🛠️ Manual / Development Setup

git clone https://github.com/sayeeddesignerz-creator/Hyper-Motion.git
cd Hyper-Motion
python -m venv .venv
.venv\Scripts\activate          # Windows
# source .venv/bin/activate     # macOS/Linux
pip install -e ".[dev]"
hypermotion init
hypermotion start

Run tests:

pytest tests/ -v

⚠️ Security

• Never commit .env — it is excluded by .gitignore
• All output (data/, output/) is local to your machine
• Facebook tokens are stored only in your .env — not logged or transmitted anywhere except the Meta Graph API
• Rotate any API key that was accidentally exposed

📄 License

MIT © sayeeddesignerz-creator