linkedin-viral-automation

Turn your LinkedIn feed into a traffic‑magnet without writing a single post.

🔥 Why This Project?

In a world where personal branding is a career accelerator, LinkedIn Viral Automation gives you the power of AI‑driven content creation, media handling, and precise scheduling—all from a single, open‑source repo. It’s the secret sauce that top influencers use to stay top‑of‑mind while you focus on what truly matters: your expertise.

✨ Key Features

• AI‑Powered Copywriting – Leverages multiple AI providers to generate click‑worthy headlines and body copy.
• Smart Media Manager – Automatically optimizes images, videos, and PDFs for LinkedIn’s specifications.
• Viral Scheduler – Predictive posting times based on historical engagement data.
• Full‑Stack Architecture – Python backend (FastAPI‑style) + React + Vite + Tailwind CSS frontend.
• Git‑History Builder – Auto‑creates clean commit history for every scheduled post (perfect for audit trails).
• CLI & API – Manage posts via terminal or integrate with your own tools.
• Zero‑Cost Open Source – No hidden fees, fully customizable, MIT‑licensed.

🚀 Installation & Usage

1️⃣ Prerequisites

• Python 3.10+
• Node.js 18+ & npm
• A LinkedIn developer app (client ID & secret) for API access.

2️⃣ Clone & Setup Backend

git clone https://github.com/AshrafMorningstar/linkedin-viral-bot.git
cd linkedin-viral-bot/backend
python -m venv .venv
source .venv/bin/activate   # Windows: .venv\Scripts\activate
pip install -r requirements.txt

Create a .env file (copy from .env.example):

LINKEDIN_CLIENT_ID=your_client_id
LINKEDIN_CLIENT_SECRET=your_client_secret
OPENAI_API_KEY=your_openai_key
DATABASE_URL=sqlite:///./data.db

Run database migrations (if any) and start the service:

python create_git_history.py   # optional: seed commit history
python main.py                 # starts the backend server

3️⃣ Setup Frontend

cd ../frontend
npm install
npm run dev            # local dev server at http://localhost:5173

4️⃣ Schedule a Post (CLI)

cd ../backend
python cli.py schedule \
  --topic "AI in Healthcare" \
  --platform linkedin \
  --schedule "2024-02-15 09:00"

The bot will:

1. Generate copy via the selected AI provider.
2. Pull or create media with media_manager.py.
3. Store the draft in the SQLite DB.
4. Post automatically at the scheduled time.

5️⃣ Monitoring

Visit http://localhost:8000/dashboard (FastAPI‑generated UI) to view upcoming posts, logs, and performance metrics.

🌐 Search Engine Optimization (SEO) Keywords

• linkedin viral automation
• ai generated linkedin posts
• social media scheduler python
• react vite tailwind starter
• linkedin content bot open source
• seo friendly linkedin automation
• python backend ai providers
• media manager for linkedin
• viral content scheduler
• linkedin engagement boost

---

Boost your LinkedIn presence with code that works while you sleep.