Skip to content

Aashutosh31/arc-ai-project

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

101 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

πŸ€– ARC-AI: Autonomous Real-time Conversational Agent

A MERN-stack Digital Assistant featuring RAG Memory, Live Web Research, Proactive Cron Routines, and Serverless Microservices.

ARC-AI Demo

πŸ”— Click the image to try the Live Application


πŸš€ Overview

ARC-AI (Autonomous Real-time Conversational AI) is a full-stack, voice-activated digital assistant that moves beyond traditional reactive chatbots into a proactive, autonomous agent.

It can:

  • 🌐 Fetch real-time data from the internet
  • ⏰ Schedule and execute background tasks
  • 🧠 Remember user data using vector embeddings (RAG)
  • 🎯 Dynamically control the frontend UI
  • πŸ“© Communicate externally via serverless webhooks

πŸŽ₯ Main Showcase Demo

▢️ https://www.youtube.com/watch?v=jt7q8v5KsrU


🧠 Architectural Deep Dive

ARC-AI uses a low-latency pipeline combining REST APIs and WebSockets.

Request Lifecycle

  1. Input – Voice (Web Speech API) or Text
  2. WebSocket Emission – Frontend sends ai:stt:final
  3. Agent Routing – Context + memory collected
  4. Tool Evaluation – LLM decides required tools
  5. Execution – Backend executes tools autonomously
  6. Streaming – Token-by-token response via sockets
  7. UI Actuation – Direct frontend control

πŸ› οΈ Core Features

πŸŽ₯ 1. GPT-4o Live Vision

  • Real-time webcam video feed for live vision input
  • Captures the current camera frame when the user speaks
  • Pipes the frame directly into the existing ai:stt:final socket payload
  • Routes visual context to the Pixtral vision model for dynamic understanding

πŸŽ₯ Demo: https://www.instagram.com/aashutosh_vaishnav.31/reel/DX84FejNgwo/


🧠 1. Infinite Memory (RAG)

  • Vector embeddings via Mistral
  • Pinecone for semantic search
  • Long-term personalized memory

πŸŽ₯ Demo: https://www.instagram.com/aashutosh_vaishnav.31/reel/DW83J1HESyQ/


🌐 2. Live Web Research

  • Real-time scraping using Cheerio
  • API-based search, weather, news

πŸŽ₯ Demo: https://www.instagram.com/aashutosh_vaishnav.31/reel/DW31J3bEbu9/


⏰ 3. Proactive Routine Engine

  • Natural language β†’ cron jobs
  • Background execution system

πŸŽ₯ Demo: https://www.instagram.com/aashutosh_vaishnav.31/reel/DW7DQ8lE-Wr/


πŸ“© 4. External Communication

  • Autonomous email sending
  • Serverless webhook integration

πŸ–₯️ 5. UI Actuation

  • Change theme
  • Open websites
  • Play media
  • Copy to clipboard

πŸŽ₯ Demo: https://www.instagram.com/aashutosh_vaishnav.31/reel/DWzcz9YE797/


πŸ’‘ Advanced Engineering Highlights

πŸ”Ή Multi-Tab WebSocket Broadcasting

  • Handles multiple tabs per user
  • Prevents duplicate events using timestamp locks

πŸ”Ή Serverless Email Bypass

  • Google Apps Script webhook
  • Bypasses SMTP restrictions
  • 100% reliable production delivery

πŸ’» Tech Stack

Category Technologies
Frontend React 18, Vite, Tailwind CSS, Web Speech API
Backend Node.js, Express.js, Socket.IO, node-cron
Database MongoDB Atlas, Pinecone
AI/ML Mistral AI, Pixtral
Infra Google Apps Script

βš™οΈ Local Setup

Prerequisites

  • Node.js (v18+)
  • MongoDB Atlas
  • Mistral API Key
  • Pinecone API Key

1. Clone Repo

git clone https://github.com/Aashutosh31/arc-ai-project.git
cd arc-ai-project

2. Backend

cd server
npm install

Create .env:

PORT=5000
MONGO_URI=your_mongodb_connection_string
JWT_SECRET=your_secret
MISTRAL_API_KEY=your_key
PINECONE_API_KEY=your_key
EMAIL_WEBHOOK=your_webhook
FRONTEND_URL=http://localhost:5173

Run:

npm run dev

3. Frontend

cd ../client
npm install
npm run dev

⚠️ Attribution Required

This project is open-source under the MIT License.

You are free to use, modify, and distribute this code. However:

  • You MUST provide proper credit to the original author
  • You MUST include a link to this repository
  • You MUST NOT claim this project as your own work

πŸ“ License

This project is licensed under the MIT License.


πŸ‘¨β€πŸ’» Author & Original Creator

Aashutosh Bairagi

  • Built ARC-AI from scratch (architecture, backend, agent system, RAG pipeline, UI actuation)
  • First published with live demo and deployment

πŸ”— GitHub: https://github.com/Aashutosh31 πŸ”— LinkedIn: https://www.linkedin.com/in/aashutosh-bairagi-559aa530b/ 🐦 Twitter/X: https://x.com/Aashutosh_dev31

If you are viewing this project elsewhere, verify the original source here.


⭐ If you found this project interesting, consider starring the repo!