🤖 Agentic CMS Portfolio

A self-updating, production-grade AI-powered Portfolio & Content Management System built using LangChain, Google Gemini, and a fully automated CI/CD pipeline.

---

🌐 Live Demo

🚀 Production URL: https://agenticportfolio.onrender.com

Every push to main automatically builds a Docker image, pushes it to Docker Hub, and deploys to Render.

---

📖 Overview

This is not a static portfolio. This is a Business-Ready Agentic Content Management System.

Instead of manually editing code, this platform uses a LangChain-powered AI Agent to:

• ✍️ Write blogs
• 🧱 Add or update projects
• 🧠 Modify bio & services
• 📩 Handle client messages
• 🎤 Accept voice commands

All through natural language inside a secure Admin Dashboard.

---

✨ Key Features

🤖 AI & Automation

• 🧠 Intelligent Orchestrator: Uses LangChain + Pydantic to analyze intent (Blog / Project / Bio / Services).
• 📄 Smart Parsing: Paste raw README text → Agent converts it into structured Project Cards.
• 🎤 Voice Command: Integrated Web Speech API allows hands-free content generation.
• 🪄 Agentic Routing: Automatically decides whether to:
  • Generate content
  • Update DB
  • Rewrite sections
  • Store history

---

💼 Business Tools

• 📬 Client Inbox: Public “Contact Me” form sends messages directly to Admin Dashboard.
• 🧾 Project Manager: AI adds, formats, and structures portfolio projects.
• 📰 Blog Engine: AI writes structured blog posts with headings and sections.
• 🧠 Services Section: Editable via AI prompts.

---

🎨 UI & UX

• 🖤 Premium Dark Theme: Monochrome, grid-based cyber aesthetic.
• 🧠 Brain Watermark Animation
• 📱 Fully Responsive: Mobile, tablet, desktop optimized.
• ⚡ Dynamic Content: Everything updates live from the database.

---

🔐 Security & Data

• 🔒 Session-Based Admin Auth
• 🗝️ Environment-Based Secrets
• 🧾 History Logging: All AI output logged to history.txt
• 🧱 Isolated Admin Routes

---

🛠️ Technology Stack

Backend

• Flask (Python)
• Gunicorn (Production Server)

AI Engine

• LangChain
• Google Gemini 2.5 Flash
• Pydantic Structured Outputs

Frontend

• HTML5, Jinja2
• Bootstrap 5
• Custom CSS
• Web Speech API

Database

• SQLite (Projects, Blogs, Messages, About, Services)

DevOps

• Docker
• GitHub Actions (CI/CD)
• Docker Hub (Registry)
• Render (Deployment)

---

⚙️ CI/CD Pipeline (Fully Automated)

On every push to main:

1. ✅ GitHub Actions builds Docker image
2. ✅ Pushes image to Docker Hub
3. ✅ Triggers Render Deploy Hook
4. ✅ Render pulls latest image
5. ✅ Zero-touch production update 🚀

---

🚀 Installation & Local Setup

1️⃣ Clone the Repository

git clone https://github.com/yourusername/agentic-portfolio.git
cd agentic-portfolio

2️⃣ Create Virtual Environment

python -m venv venv

# Windows
venv\Scripts\activate

# Mac/Linux
source venv/bin/activate

3️⃣ Install Dependencies

pip install -r requirements.txt

4️⃣ Configure Environment Variables

GEMINI_API_KEY=your_google_api_key_here
FLASK_SECRET_KEY=your_secret_key_here
ADMIN_PASSWORD=your_admin_password
COMPANY_EMAIL=your_email
EMAIL_PASSWORD=your_app_password

5️⃣ Run the App

python app.py

Visit:
👉 http://127.0.0.1:5000

🕹️ How to Use the Agent

Go to -> /admin
Login using your admin password.

➕ Add a Project

Prompt: Copy and paste your projects Readme.md or describe it in your style.
Result:
AI creates a structured project card
Extracts tech stack
Formats description
Saves to DB (On click 'Publish')

✍️ Write a Blog

Prompt: Write a blog about Vector Databases in RAG systems.
Result:
AI generates a full article
With headings and structure

On click 'Publish':
Saves to blog section
Saves to 

🧠 Update Bio

Prompt: Update my about section. I am now focusing on Agentic Workflows and Generative AI.
Result:
AI rewrites About section
Updates skills and focus

📂 Project Structure

Portfolio/
├── data/               # SQLite DB + history logs
├── src/
│   ├── agent.py        # LangChain agent + routing logic
│   ├── db.py           # Database operations
│   ├── logg.py         # Logging & history writer
│   ├── prompt.py       # System prompts
├── static/
│   └── style.css       # Custom UI theme
├── templates/
│   ├── base.html
│   ├── index.html
│   ├── admin.html
│   └── login.html
├── app.py              # Flask app entry
├── Dockerfile
├── requirements.txt
└── README.md

🧠 Architecture

User → Admin Panel → LangChain Router → Gemini
                         ↓
                  Pydantic Validator
                         ↓
                   Database Writer
                         ↓
                  Live Website Update

🤝 Contributing

Fork this repo and customize: src/agent.py
You can:
Change the system personality
Change writing style
Add new agent tools
Add analytics
Add payment systems

This Project Demonstrates

This demonstrates:
✅ Agentic AI systems
✅ Real DevOps CI/CD
✅ Production deployment
✅ Dockerized backend
✅ Secure secret management
✅ AI orchestration
✅ Business-grade architecture

Built with obsession and engineering discipline.