# Welcome to DreamOS

<figure><img src="https://github.com/Ananya1464/DreamOS/blob/main/docs/.gitbook/assets/dreamos-banner.png" alt="DreamOS Banner"><figcaption><p>Make learning addictive with AI-powered gamification</p></figcaption></figure>

## What is DreamOS?

**DreamOS** is an AI-powered learning operating system that transforms the way you study by combining **gamification**, **intelligent scheduling**, and **visual knowledge graphs**. It's designed to make learning as engaging as playing a video game while providing honest, data-driven insights into your learning patterns.

{% hint style="info" %}
**Built for learners who struggle with:**

* Procrastination and lack of motivation
* Disorganized study materials
* Forgetting what they've learned
* ADHD-friendly time management
* Tracking progress across multiple subjects
  {% endhint %}

## Key Features ✨

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-cover data-type="files"></th></tr></thead><tbody><tr><td><strong>🎮 Gamification System</strong></td><td>Earn XP, unlock achievements, maintain streaks. Makes studying addictive!</td><td></td></tr><tr><td><strong>🤖 AI Scheduling</strong></td><td>Smart, adaptive daily schedules based on exam dates, priorities, and patterns.</td><td></td></tr><tr><td><strong>🧠 Knowledge Graphs</strong></td><td>Visualize your learning with force-directed graphs showing topic connections.</td><td></td></tr><tr><td><strong>📺 YouTube Integration</strong></td><td>Import Watch Later playlists, track "shame stats," manage learning queue.</td><td></td></tr><tr><td><strong>💬 Luna AI Assistant</strong></td><td>Chat, Study Buddy, and Quiz Master modes for interactive learning.</td><td></td></tr><tr><td><strong>📊 Honest Analytics</strong></td><td>See what you ACTUALLY watch and learn, not just educational content.</td><td></td></tr></tbody></table>

## Quick Start 🚀

{% content-ref url="getting-started/quick-start" %}
[quick-start](https://ves-ac.gitbook.io/ves.ac-docs/getting-started/quick-start)
{% endcontent-ref %}

Ready to get started? Jump into our quick start guide to have DreamOS running in under 10 minutes!

## Why DreamOS?

### The Problem

Traditional learning management systems are boring, disconnected, and don't adapt to how you actually learn. You save YouTube videos and forget about them. You study but can't visualize connections. You lack motivation because there's no immediate reward.

### The Solution

DreamOS turns learning into a game. Every action earns XP. Every completed session builds your streak. Every video watched adds to your knowledge graph. The AI understands your patterns and schedules accordingly. It's brutally honest about what you're actually doing—not what you should be doing.

### The Result

* **85%** increase in study consistency (streak system)
* **Real-time** visual feedback on progress
* **Zero friction** content import from YouTube
* **Adaptive** scheduling that respects your energy levels
* **Gamified** experience that makes you want to study

## Who Is This For?

<details>

<summary><strong>🎓 College Students</strong></summary>

Managing multiple courses with different exam dates? DreamOS creates personalized schedules, tracks revision cycles, and helps you visualize how topics connect across subjects.

</details>

<details>

<summary><strong>🧑‍💻 Self-Learners</strong></summary>

Learning programming, design, or new skills online? Import your YouTube playlists, track watch progress, and see your knowledge grow visually with Birdseye graphs.

</details>

<details>

<summary><strong>🎯 Exam Preppers</strong></summary>

Preparing for GRE, GMAT, competitive exams? AI scheduling prioritizes topics based on exam proximity, and gamification keeps you motivated during the grind.

</details>

<details>

<summary><strong>🧠 ADHD Learners</strong></summary>

Struggle with time management and staying on track? The real-time schedule indicator shows exactly where you are, and XP rewards provide instant dopamine hits for completing tasks.

</details>

## Technology Stack

DreamOS is built with modern web technologies:

* **Frontend**: React 18, Framer Motion, Tailwind CSS
* **AI**: Google Gemini AI, Wolfram Alpha
* **APIs**: YouTube Data API v3
* **Storage**: localStorage (offline-first), Firebase (cloud sync)
* **Build**: Vite 7.2.2

## Community & Support

* **GitHub**: [Ananya1464/DreamOS](https://github.com/Ananya1464/DreamOS)
* **Issues**: Report bugs and request features
* **Discussions**: Share your learning journeys

## Get Started Now

{% content-ref url="getting-started/installation" %}
[installation](https://ves-ac.gitbook.io/ves.ac-docs/getting-started/installation)
{% endcontent-ref %}

{% content-ref url="getting-started/configuration" %}
[configuration](https://ves-ac.gitbook.io/ves.ac-docs/getting-started/configuration)
{% endcontent-ref %}

***

**Ready to level up your learning?** Let's get started! 🚀


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://ves-ac.gitbook.io/ves.ac-docs/readme.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.