Skip to content

README.md

Latest commit

 

History

History
335 lines (244 loc) · 13.7 KB

README.md

File metadata and controls

335 lines (244 loc) · 13.7 KB

⚡ Varsh.AI | Next-Gen Intelligent Portfolio

GIF_Video_Generation_for_README.mp4

Live demonstration of the Soul Foods Strategic Decision Engine

Python FastAPI Tailwind CSS Groq AI Status

"Not just a portfolio. An intelligent system."

Varsh.AI is a full-stack, AI-integrated portfolio platform designed to showcase advanced engineering skills through a futuristic lens. Unlike static resume sites, this project features a live Neural Terminal powered by the Llama 3.3 (70B) model running on Groq LPU hardware, capable of real-time code debugging, ELI5 explanations, and conversational interactions.

🌐 Live Deployment

🚀 Launch System (Visit Site)

Hosted on Render Cloud (Singapore Region)

🎨 Core Identity & Visuals

  • Theme: Cyberpunk / High-Tech Industrial.
  • Palette: Neon Blue (#00E6FF), Warning Red (#FF003C), Void Black (#0a0a0a).
  • UX Dynamics: Glass-morphism, holographic tilt effects, typewriter telemetry, and fluid mobile responsiveness.

🛠️ The Tech Stack (Arsenal)

This project allows no compromise on performance. It bridges a modern frontend with a high-performance Python backend.

Component Technology Description
Backend Core FastAPI (Python) High-performance async web framework handling API routing and logic.
Frontend UI HTML5 + Tailwind Utility-first CSS for rapid, responsive, and cinematic UI design.
Templating Jinja2 Server-side rendering for dynamic content and modular architecture.
Intelligence Groq + Llama 3.3 The world's fastest inference engine running Meta's 70B parameter model.
Deployment Render Continuous Deployment (CI/CD) directly from GitHub.

🧠 Key Features

1. 🤖 The AI Playground (Neural Terminal)

A fully functional command-line interface (CLI) in the browser.

  • Tech: Uses fetch() to send async JSON payloads to the /chat endpoint.
  • Modes:
    • Explain: Simplifies complex CS concepts (ELI5).
    • Debug: Analyzes code snippets and suggests fixes.
    • General: Chat about my resume and skills.
  • Latency: Sub-second responses via Groq LPUs.

2. ⚡ Dynamic Hero Section

  • Features a responsive "Typewriter" effect cycling through roles (AI ENGINEER, DATA SCIENTIST).
  • Mobile Optimized: Text scales dynamically from text-4xl on phones to text-8xl on desktops.

3. 🛡️ Contact Terminal

  • A "gamified" contact form styled as a secure uplink.
  • Uses strict Pydantic validation on the backend to ensure data integrity.

📂 Project Structure

Portfolio-Website/
├── app/
│   ├── main.py              # ⚡ The Brain: FastAPI app & Groq Integration
│   ├── static/              # 🎨 CSS, Images, PDF Resume
│   │   └── css/
│   │       └── style.css
│   └── templates/           # 🧩 Jinja2 HTML Templates
│       ├── base.html        # Master layout (Navbar/Footer)
│       ├── index.html       # Homepage (Hero/Skills)
│       ├── playground.html  # AI Terminal Interface
│       └── projects.html    # Project Showcase
├── requirements.txt         # 📦 Dependencies
├── runtime.txt              # 🐍 Python Version for Render
└── README.md                # 📄 Documentation

Here is a Premium, 10/10 README.md file tailored specifically for your project. It is structured to look professional on GitHub, matching the "High-Tech/Cyberpunk" aesthetic of your website.

You can copy and paste this directly into your README.md file.

Markdown

# ⚡ Varsh.AI | Next-Gen Intelligent Portfolio

![Python](https://img.shields.io/badge/Python-3.9%2B-blue?style=for-the-badge&logo=python)
![FastAPI](https://img.shields.io/badge/FastAPI-0.95%2B-009688?style=for-the-badge&logo=fastapi)
![Tailwind CSS](https://img.shields.io/badge/Tailwind_CSS-3.0-38B2AC?style=for-the-badge&logo=tailwind-css)
![Groq AI](https://img.shields.io/badge/AI_Engine-GROQ_Llama_3.3-ff5722?style=for-the-badge)
![Status](https://img.shields.io/badge/Status-Operational-success?style=for-the-badge)

> **"Not just a portfolio. An intelligent system."**

**Varsh.AI** is a full-stack, AI-integrated portfolio platform designed to showcase advanced engineering skills through a futuristic lens. Unlike static resume sites, this project features a live **Neural Terminal** powered by the **Llama 3.3 (70B)** model running on **Groq LPU hardware**, capable of real-time code debugging, ELI5 explanations, and conversational interactions.

---

## 🌐 Live Deployment
### [🚀 Launch System (Visit Site)](https://varsh-v-portfolio.onrender.com)
*Hosted on Render Cloud (Singapore Region)*

---

## 🎨 Core Identity & Visuals
* **Theme:** Cyberpunk / High-Tech Industrial.
* **Palette:** `Neon Blue (#00E6FF)`, `Warning Red (#FF003C)`, `Void Black (#0a0a0a)`.
* **UX Dynamics:** Glass-morphism, holographic tilt effects, typewriter telemetry, and fluid mobile responsiveness.

---

## 🛠️ The Tech Stack (Arsenal)

This project allows no compromise on performance. It bridges a modern frontend with a high-performance Python backend.

| Component | Technology | Description |
| :--- | :--- | :--- |
| **Backend Core** | **FastAPI (Python)** | High-performance async web framework handling API routing and logic. |
| **Frontend UI** | **HTML5 + Tailwind** | Utility-first CSS for rapid, responsive, and cinematic UI design. |
| **Templating** | **Jinja2** | Server-side rendering for dynamic content and modular architecture. |
| **Intelligence** | **Groq + Llama 3.3** | The world's fastest inference engine running Meta's 70B parameter model. |
| **Deployment** | **Render** | Continuous Deployment (CI/CD) directly from GitHub. |

---

## 🧠 Key Features

### 1. 🤖 The AI Playground (Neural Terminal)
A fully functional command-line interface (CLI) in the browser.
* **Tech:** Uses `fetch()` to send async JSON payloads to the `/chat` endpoint.
* **Modes:**
    * `Explain`: Simplifies complex CS concepts (ELI5).
    * `Debug`: Analyzes code snippets and suggests fixes.
    * `General`: Chat about my resume and skills.
* **Latency:** Sub-second responses via Groq LPUs.

### 2. ⚡ Dynamic Hero Section
* Features a responsive "Typewriter" effect cycling through roles (`AI ENGINEER`, `DATA SCIENTIST`).
* **Mobile Optimized:** Text scales dynamically from `text-4xl` on phones to `text-8xl` on desktops.

### 3. 🛡️ Contact Terminal
* A "gamified" contact form styled as a secure uplink.
* Uses strict Pydantic validation on the backend to ensure data integrity.

---

## 📂 Project Structure

```bash
Portfolio-Website/
├── app/
│   ├── main.py              # ⚡ The Brain: FastAPI app & Groq Integration
│   ├── static/              # 🎨 CSS, Images, PDF Resume
│   │   └── css/
│   │       └── style.css
│   └── templates/           # 🧩 Jinja2 HTML Templates
│       ├── base.html        # Master layout (Navbar/Footer)
│       ├── index.html       # Homepage (Hero/Skills)
│       ├── playground.html  # AI Terminal Interface
│       └── projects.html    # Project Showcase
├── requirements.txt         # 📦 Dependencies
├── runtime.txt              # 🐍 Python Version for Render
└── README.md                # 📄 Documentation

⚙️ Local Installation
Want to run this system on your local machine?

git clone [https://github.com/VarshVishwakarma/Portfolio-Website.git](https://github.com/VarshVishwakarma/Portfolio-Website.git)
cd Portfolio-Website

2. Initialize Environment
# Create virtual environment
python -m venv venv

# Activate (Windows)
venv\Scripts\activate

# Activate (Mac/Linux)
source venv/bin/activate

3. Install Dependencies
pip install -r requirements.txt

Here is a Premium, 10/10 README.md file tailored specifically for your project. It is structured to look professional on GitHub, matching the "High-Tech/Cyberpunk" aesthetic of your website.

You can copy and paste this directly into your README.md file.

Markdown

# ⚡ Varsh.AI | Next-Gen Intelligent Portfolio

![Python](https://img.shields.io/badge/Python-3.9%2B-blue?style=for-the-badge&logo=python)
![FastAPI](https://img.shields.io/badge/FastAPI-0.95%2B-009688?style=for-the-badge&logo=fastapi)
![Tailwind CSS](https://img.shields.io/badge/Tailwind_CSS-3.0-38B2AC?style=for-the-badge&logo=tailwind-css)
![Groq AI](https://img.shields.io/badge/AI_Engine-GROQ_Llama_3.3-ff5722?style=for-the-badge)
![Status](https://img.shields.io/badge/Status-Operational-success?style=for-the-badge)

> **"Not just a portfolio. An intelligent system."**

**Varsh.AI** is a full-stack, AI-integrated portfolio platform designed to showcase advanced engineering skills through a futuristic lens. Unlike static resume sites, this project features a live **Neural Terminal** powered by the **Llama 3.3 (70B)** model running on **Groq LPU hardware**, capable of real-time code debugging, ELI5 explanations, and conversational interactions.

---

## 🌐 Live Deployment
### [🚀 Launch System (Visit Site)](https://varsh-v-portfolio.onrender.com)
*Hosted on Render Cloud (Singapore Region)*

---

## 🎨 Core Identity & Visuals
* **Theme:** Cyberpunk / High-Tech Industrial.
* **Palette:** `Neon Blue (#00E6FF)`, `Warning Red (#FF003C)`, `Void Black (#0a0a0a)`.
* **UX Dynamics:** Glass-morphism, holographic tilt effects, typewriter telemetry, and fluid mobile responsiveness.

---

## 🛠️ The Tech Stack (Arsenal)

This project allows no compromise on performance. It bridges a modern frontend with a high-performance Python backend.

| Component | Technology | Description |
| :--- | :--- | :--- |
| **Backend Core** | **FastAPI (Python)** | High-performance async web framework handling API routing and logic. |
| **Frontend UI** | **HTML5 + Tailwind** | Utility-first CSS for rapid, responsive, and cinematic UI design. |
| **Templating** | **Jinja2** | Server-side rendering for dynamic content and modular architecture. |
| **Intelligence** | **Groq + Llama 3.3** | The world's fastest inference engine running Meta's 70B parameter model. |
| **Deployment** | **Render** | Continuous Deployment (CI/CD) directly from GitHub. |

---

## 🧠 Key Features

### 1. 🤖 The AI Playground (Neural Terminal)
A fully functional command-line interface (CLI) in the browser.
* **Tech:** Uses `fetch()` to send async JSON payloads to the `/chat` endpoint.
* **Modes:**
    * `Explain`: Simplifies complex CS concepts (ELI5).
    * `Debug`: Analyzes code snippets and suggests fixes.
    * `General`: Chat about my resume and skills.
* **Latency:** Sub-second responses via Groq LPUs.

### 2. ⚡ Dynamic Hero Section
* Features a responsive "Typewriter" effect cycling through roles (`AI ENGINEER`, `DATA SCIENTIST`).
* **Mobile Optimized:** Text scales dynamically from `text-4xl` on phones to `text-8xl` on desktops.

### 3. 🛡️ Contact Terminal
* A "gamified" contact form styled as a secure uplink.
* Uses strict Pydantic validation on the backend to ensure data integrity.

---

## 📂 Project Structure

```bash
Portfolio-Website/
├── app/
│   ├── main.py              # ⚡ The Brain: FastAPI app & Groq Integration
│   ├── static/              # 🎨 CSS, Images, PDF Resume
│   │   └── css/
│   │       └── style.css
│   └── templates/           # 🧩 Jinja2 HTML Templates
│       ├── base.html        # Master layout (Navbar/Footer)
│       ├── index.html       # Homepage (Hero/Skills)
│       ├── playground.html  # AI Terminal Interface
│       └── projects.html    # Project Showcase
├── requirements.txt         # 📦 Dependencies
├── runtime.txt              # 🐍 Python Version for Render
└── README.md                # 📄 Documentation
⚙️ Local Installation
Want to run this system on your local machine?

1. Clone the Repository
Bash

git clone [https://github.com/VarshVishwakarma/Portfolio-Website.git](https://github.com/VarshVishwakarma/Portfolio-Website.git)
cd Portfolio-Website
2. Initialize Environment
Bash

# Create virtual environment
python -m venv venv

# Activate (Windows)
venv\Scripts\activate

# Activate (Mac/Linux)
source venv/bin/activate
3. Install Dependencies
Bash

pip install -r requirements.txt

4. Configure API Keys
Create a .env file in the root directory and add your Groq Cloud API Key:
GROQ_API_KEY=gsk_your_api_key_here

5. Launch System
uvicorn app.main:app --reload
Access the uplink at: http://127.0.0.1:8000

🏆 Achievements & Integrations
TCS CodeVita S13: Global Rank 1573 (Round 2 Qualifier).

IBM SkillsBuild: Integrated badge & verified internship credentials.

J.P. Morgan: Virtual Software Engineering experience simulation.

📬 Contact Uplink
Operator: Varsh Vishwakarma

Location: Bhopal, India

Role: Aspiring AI Engineer / BCA Student

Email: varshv2007@gmail.com

"The best way to predict the future is to invent it."

© 2025 Varsh.AI | All Systems Operational

🧑‍💻 Author
Varsh Vishwakarma
AI • ML • DL • Data Science • Cloud • Full-Stack ML Developer

Building scalable intelligent systems that solve real business problems.