Skip to content

Far-200/cortex-ai-assistant

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

3 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🚀 Cortex AI

Cortex AI is a clean full-stack AI chatbot built with React + Express and powered by the Google Gemini API.

It focuses on a developer-friendly chat experience, supporting formatted responses, code blocks, and contextual follow-up questions.


✨ Features

  • 🤖 AI responses powered by Google Gemini
  • 🧠 Smart follow-up based on selected text
  • 🧾 Markdown rendering for readable responses
  • 💻 Code block support with proper formatting
  • 📋 Copy response button for quick reuse
  • ⚡ Smooth chat UI built with React + Tailwind
  • 🔁 Auto-scroll chat conversation
  • ⌨️ Send messages using Enter key

🛠 Tech Stack

Frontend

  • React
  • Tailwind CSS
  • React Markdown

Backend

  • Node.js
  • Express.js
  • Gemini API

📂 Project Structure

Cortex-AI
│
├── client
│   ├── src
│   │   ├── components
│   │   │   ├── ChatBox.jsx
│   │   │   ├── ChatInput.jsx
│   │   │   └── MessageBubble.jsx
│   │   └── App.jsx
│
├── server
│   ├── server.js
│   └── .env
│
└── README.md

⚙️ Setup Instructions

1️⃣ Clone the repository

git clone https://github.com/Far-200/cortex-ai-assistant.git
cd Cortex-AI

2️⃣ Install dependencies

Frontend

cd client
npm install

Backend

cd ../server
npm install

3️⃣ Add your Gemini API key

Create a .env file inside server

GEMINI_API_KEY=your_api_key_here

4️⃣ Start the backend

cd server
npm run dev

Server runs on

http://localhost:5000

5️⃣ Start the frontend

cd client
npm run dev

Open:

http://localhost:5173

💡 Example Usage

Ask Cortex:

Write a Python function for factorial

Cortex will respond with:

  • formatted explanation
  • syntax highlighted code
  • copyable response

You can select any part of the response and click Follow up to ask a contextual question.


🎯 Future Improvements

  • Conversation memory
  • Syntax highlighting
  • Chat history persistence
  • Streaming responses
  • Deploy to Vercel + Render

📜 License

This project is licensed under the MIT License.


👨‍💻 Author

Farhaan Khan

CSE Student • Full-stack Builder • AI Explorer

About

Nova AI — a full-stack AI chatbot built with React and Express featuring smart follow-ups and developer-friendly responses.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors