🧠 PerceptOS – The Emotional Reality Interpreter

What if the world wasn’t just seen… but felt through your emotional lens?

🔗 Live App: https://perceptos.macaly-app.com

---

🌍 Overview

PerceptOS is a first-of-its-kind AI-powered interpreter that transforms news, events, and content based on your unique emotional makeup.

By analyzing your emotional DNA, personality traits, traumas, and beliefs, it mirrors the world not just as it is — but as you experience it.

---

🎯 Use Cases

• Personalized news & media reinterpretation
• Emotional intelligence development
• Mental health & trauma-awareness tools
• Cognitive bias detection & empathy training
• Reflective journaling & introspection

---

💎 Features

🧬 Emotional DNA Setup

Define your emotional traits, fears, biases, and triggers.

🧠 Cognitive Lens Modes

Choose how reality is filtered:

• Empathy Boost
• Radical Honesty
• Trauma Shield
• Realist vs Optimist/Pessimist Mode
• Archetypal Voices (Child, Healer, Rebel, etc.)

🪞 Mirror View

See both:

• 🧾 Objective Interpretation
• 💭 Your Emotional Perception

🎙️ Multi-Voice Output

Rewrites news or situations in various emotional archetypes.

---

🛠️ Tech Stack

Area	Tools Used
Frontend	React.js 18, Next.js 15, Tailwind CSS
Backend	Node.js / FastAPI, Vercel Functions
AI/LLMs	OpenAI GPT-4o
State Mgmt	Zustand, Context API
Storage	LocalStorage (temporary)
Hosting	Vercel (via Macaly.app)

---

🧩 Suggested Folder Structure

perceptos/ ├── frontend/ # React + Next.js │ ├── components/ │ ├── pages/ │ ├── styles/ │ └── utils/ ├── prompts/ # GPT prompt templates ├── public/ # Static assets ├── docs/ │ ├── emotional-models.md │ ├── vision.md │ └── launch-deck/ ├── .env.example └── README.md

🧪 Running Locally

# 1. Clone the repo
git clone https://github.com/fahadnasir13/perceptos.git
cd perceptos/frontend

# 2. Install dependencies
npm install

# 3. Create .env file with your OpenAI key
cp .env.example .env

# 4. Start development server
npm run dev
✨ Upcoming Features
 AI-guided Emotional Journaling

 Real-Time Media Feeds

 Audio Narration (Voice Archetypes)

 Bias Analyzer Dashboard

 User Feedback/Insight Tracking

🏆 #MadeInMacaly Submission
Built for the #MadeInMacaly 2025 competition to explore the intersection of AI, emotion, and reality.

👤 Creator
Fahad Nasir
AI & Full Stack Innovator

🔗 GitHub: https://github.com/fahadnasir13

🔗 LinkedIn: https://linkedin.com/in/fahadnasir15

🌐 Portfolio: https://fahadnasir.macaly-app.com

📄 License
MIT License – Free to use, fork, and remix with credit.

💬 Feedback or Collaboration?
Open to mental health experts, AI builders, educators, and emotional design thinkers.
Fork it, star it, or drop a suggestion!



---

## ✅ Commit Structure Suggestion

```bash
git commit -m "init: setup Next.js frontend with Tailwind"
git commit -m "feat: add Emotional DNA input flow"
git commit -m "feat: implement Mirror View comparison layout"
git commit -m "chore: add OpenAI API integration"
git commit -m "style: responsive redesign for lens selector"
git commit -m "docs: complete README and vision doc"