Skip to content

RAVX OS 🎛️ — The AI operating system 🤖 for non-coders to create powerful AI agents 🧠, automate real-world tasks ⚡, and speak with life like voice 🎙️ — all without writing a single line of code 🚀.

Notifications You must be signed in to change notification settings

201Harsh/RAVX-OS

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🧬 RAVX OS — The Personal AI Avatar Operating System

MIT License

RAVX OS Banner

RAVX OS is a futuristic AI Avatar Operating System that empowers non-coders to create, customize, and command intelligent AI agents capable of generating content, executing real-world tasks, and evolving through memory — all without writing a single line of code.


🚀 Live Demo

🔗 View Live App | 💻 GitHub Repository


📘 Table of Contents


🧠 About RAVX OS

RAVX OS redefines how humans interact with artificial intelligence.
It’s not a chatbot platform — it’s a Personal AI Operating System, where users design, train, and evolve their own digital avatars capable of performing intelligent actions through natural language.

Each user’s AI Avatar acts as their personal cognitive extension, powered by Google Gemini AI and MCP (Model Context Protocol) to execute commands, generate ideas, and remember context like a true assistant.

✨ Imagine having your own version of ChatGPT — but it talks like you, thinks like you, and remembers what matters to you.


⚗️ What is RAVX ARC Lab?

🧬 “Where AI Sparks to Life.”

RAVX ARC Lab (/arc) is the core creation zone of RAVX OS — a virtual laboratory where users bring AI avatars to life.

Inside ARC Lab, users:

  • 🧠 Describe their avatar’s personality, tone, and goals.
  • 🎭 Select traits like curiosity, creativity, humor, professionalism, etc.
  • 💬 Train behavior through system prompts and conversations.
  • 🧩 Attach tools and memory modules (like writing, research, or task execution).

Once configured, the avatar’s System Instructions and Memory Core are generated automatically — turning a simple idea into a living, interactive AI being that can think, talk, remember, and act.

ARC Lab transforms prompt engineering into personality engineering — giving non-coders the ability to shape real AI identities.


🪄 How AI Avatars Are Created

Each avatar in RAVX OS follows a 4-step life cycle:

Stage Description
🧩 Design The user describes the AI’s name, traits, tone, and purpose inside RAVX ARC.
⚙️ Synthesis The system builds a unique System Instruction Core using Gemini API — defining personality, memory, and command protocols.
💬 Activation The AI Avatar becomes interactive — users can chat, command, and guide its evolution.
🧠 Evolution Each interaction trains the avatar. Memory, behavior, and knowledge update over time via MongoDB-based storage.

Result:
Your avatar isn’t a static chatbot. It’s an adaptive digital entity that remembers, improves, and acts autonomously through RAVX’s cognitive framework.


🤖 How AI Agents Work

Each RAVX Agent is a hybrid between a conversational AI and an operational micro-agent.

When a user interacts with their avatar:

  1. Input Processing
    The user’s text or voice is sent to the Gemini API, along with system instructions and memory data.
  2. Reasoning & Intent Mapping
    The AI analyzes the request and determines intent — whether it’s a task execution, content generation, or knowledge query.
  3. Task Execution via MCP Server
    For operational tasks (like “create a blog post”, “summarize notes”, or “send a message”), the AI communicates with the MCP (Model Context Protocol) backend, which acts as a real-world execution layer.
  4. Response & Memory Storage
    The output is returned to the user, while the conversation, task, and results are logged into the avatar’s memory database for context in future interactions.

🌌 Core Features

Category Description
🧠 AI Avatar Creation (RAVX ARC) Design unique AI beings through natural prompts and traits.
🪞 Personality Engine Define tone, emotion, learning style, and identity for each avatar.
🗣 Voice Interaction Talk naturally using AI-generated voices powered by Gemini TTS.
🧩 MCP Integration Connects AI agents with real-world tools and tasks.
💾 Memory & Evolution Every chat and task builds the avatar’s memory and learning profile.
🎨 Neon UI Design Futuristic glowing interface — no hacker vibe, just clean, modern energy.
🧰 No-Code Control All configurations are done through intuitive interfaces.
📜 Conversation Logs Each chat and command stored securely for personalized continuity.

🧱 System Architecture

Layer Technologies Used
Frontend Next.js 15+, Tailwind CSS, Framer Motion, Axios
Backend Node.js, Express.js, Next.js API Routes
Database MongoDB (Atlas or Local)
AI Engine Google Gemini API (Text + TTS)
Agent Protocol Model Context Protocol (MCP)
Memory System Contextual Chat + Task History in MongoDB
Deployment Vercel (Frontend + Backend)
UI/UX Theme Neon-glow design with minimalistic aesthetics

⚙️ Installation & Usage

📦 Prerequisites

  • Node.js v18+
  • MongoDB (Local or Atlas)
  • Google Gemini API Key

🧭 Setup Instructions

1️⃣ Clone the Repository

git clone https://github.com/201Harsh/RAVX-OS.git
cd RAVX-OS

2️⃣ Install Dependencies

npm install

3️⃣ Add Environment Variables

Create a .env.local file in the root:

MONGODB_URI=your_mongodb_connection_string
GEMINI_API_KEY=your_google_gemini_api_key

4️⃣ Run the Development Server

npm run dev

Your app will run at
🌐 http://localhost:4000


🧠 Future Roadmap

Feature Status
🌍 Multi-Agent Collaboration ⏳ Planned
🗣 Voice-to-Voice Real-Time Chat 🔄 In Development
🧩 Plugin System for Custom Tools 🧱 Designing
🪙 Premium Tier with Advanced Memory 🧠 Coming Soon
💻 Desktop Client (Electron) 🔮 Concept Stage

🤝 Contributing

We welcome contributions from developers, designers, and AI enthusiasts!

  1. Fork this repository
  2. Create a feature branch
    git checkout -b feature/your-feature
  3. Commit changes
    git commit -m "Add new feature"
  4. Push to your branch
    git push origin feature/your-feature
  5. Open a Pull Request 🚀

🪪 License

MIT License
Copyright (c) 2025 Harsh
Permission is hereby granted, free of charge, to any person obtaining a copy...

📮 Contact


🌟 Final Thoughts

RAVX OS isn’t just another AI project —
it’s the Operating System for your imagination.

Create AI companions that think, remember, and evolve
and shape your own digital future inside the RAVX ARC Lab.

💫 Welcome to RAVX — where AI sparks to life.


💖 Creator’s Signature

Made with ❤️, imagination, and pure code energy — by Harsh Pandey

Every line of RAVX OS is a spark of innovation — where AI meets emotion.

About

RAVX OS 🎛️ — The AI operating system 🤖 for non-coders to create powerful AI agents 🧠, automate real-world tasks ⚡, and speak with life like voice 🎙️ — all without writing a single line of code 🚀.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published