KnowSelf

AI-Powered Self-Discovery Platform

Understand who you are through validated psychometric assessments and AI-driven conversation.

---

What is KnowSelf?

KnowSelf is a privacy-first self-discovery platform that helps you understand your cognitive abilities, emotional intelligence, and personality traits through:

• WAIS-Inspired IQ Assessment — Measures verbal comprehension, perceptual reasoning, working memory, and processing speed
• Emotional Intelligence (EQ) Test — Evaluates self-awareness, self-regulation, motivation, empathy, and social skills
• Big Five Personality Profile — Assesses openness, conscientiousness, extraversion, agreeableness, and neuroticism (OCEAN model)
• AI Conversation Agent — Engages in personalized discussions about your results to uncover deeper insights

Why KnowSelf?

• 100% Private — All data stays in your browser (localStorage). Nothing is sent to any server unless you choose to connect an AI provider.
• Multiple AI Providers — Use OpenAI, Google Gemini, Anthropic Claude, or run completely local with LM Studio/Ollama.
• Validated Frameworks — Assessments are based on established psychological models (WAIS, Big Five/IPIP-NEO).
• Open Source — Fully transparent, auditable, and community-driven.

---

How It Works

1. Quick Profile (Optional)

Share basic context like age, education, profession, and languages. This helps the AI tailor insights to your background.

2. Cognitive Assessment (IQ)

~48 questions across 4 domains measuring different aspects of intelligence:

• Verbal Comprehension — Word relationships, analogies, vocabulary
• Perceptual Reasoning — Pattern recognition, visual puzzles
• Working Memory — Number sequences, mental arithmetic
• Processing Speed — Rapid pattern matching under time pressure

3. Emotional Intelligence (EQ)

~50 scenario-based questions covering:

• Self-awareness and emotional recognition
• Self-regulation and impulse control
• Motivation and drive
• Empathy and perspective-taking
• Social skills and communication

4. Personality Profile (Big Five)

~50 questions mapping your personality across the OCEAN model:

• Openness — Creativity, curiosity, intellectual interests
• Conscientiousness — Organization, discipline, goal-directed behavior
• Extraversion — Sociability, assertiveness, energy from social interaction
• Agreeableness — Cooperation, trust, compassion
• Neuroticism — Emotional reactivity, anxiety tendencies

5. AI Deep Dive

After completing assessments, an AI agent reviews your results and engages in a personalized conversation to:

• Explore patterns across all three assessments
• Ask probing questions about your experiences
• Help you understand what your results mean practically
• Identify strengths and growth areas

---

Getting Started

Prerequisites

• Node.js 18+
• npm, yarn, pnpm, or bun

Installation

# Clone the repository
git clone https://github.com/mem0cypher/KnowSelf.git
cd KnowSelf

# Install dependencies
npm install

# Run the development server
npm run dev

Open http://localhost:3000 to start your self-discovery journey.

Production Build

npm run build
npm start

---

AI Provider Setup

KnowSelf supports multiple AI backends for the conversation agent:

Cloud Providers

Provider	Setup
OpenAI	Get an API key from platform.openai.com
Google Gemini	Get an API key from aistudio.google.com
Anthropic Claude	Get an API key from console.anthropic.com

Local Models (100% Offline)

For complete privacy, run a local LLM:

1. Install LM Studio or Ollama
2. Download a model (e.g., Llama 3, Mistral, Phi-3)
3. Start the local server:
   • LM Studio: Developer tab → Start Server (default: localhost:1234)
   • Ollama: ollama serve (default: localhost:11434)
4. Select "Local Model" in KnowSelf and connect

---

Tech Stack

• Framework: Next.js 16 (App Router)
• UI: React 19 with CSS Modules
• Font: Inter (Google Fonts)
• Build: React Compiler enabled

---

Project Structure

src/
├── app/
│   ├── api/llm-proxy/     # Local LLM CORS proxy
│   ├── assessment/        # IQ, EQ, Personality tests
│   ├── conversation/      # AI agent conversation
│   ├── explore/           # Post-results exploration
│   ├── onboarding/        # Optional profile setup
│   ├── results/           # Full profile display
│   └── page.js            # Landing page
├── data/
│   ├── iq-questions.js    # WAIS-inspired question bank
│   ├── eq-questions.js    # EQ scenario bank
│   └── personality-questions.js  # Big Five items
├── lib/
│   ├── agent.js           # Multi-provider LLM integration
│   ├── scoring-engine.js  # Assessment scoring algorithms
│   ├── question-engine.js # Question selection/shuffling
│   └── conversation-prompt.js  # AI system prompts
└── components/
    └── SoundEffects.js    # UI audio feedback

---

Contributing

Contributions are welcome! Here's how to help:

1. Fork the repository
2. Create a branch for your feature/fix
3. Make your changes with clear commits
4. Submit a pull request

Ideas for Contribution

• Additional assessment types (e.g., career aptitude, values)
• New question items for existing assessments
• UI/UX improvements
• Accessibility enhancements
• Internationalization (i18n)
• Dark mode toggle
• Export results as PDF/JSON
• More local LLM presets

---

Disclaimer

This is an educational self-discovery tool, not a clinical instrument.

The assessments are inspired by validated psychological frameworks but are not substitutes for professionally administered evaluations. For clinical assessments, please consult a licensed psychologist.

---

License

This project is open source under the MIT License.

---

Acknowledgments

• WAIS (Wechsler Adult Intelligence Scale) framework inspiration
• IPIP-NEO personality item pool structure
• Big Five / OCEAN personality model research
• OpenAI, Google, and Anthropic for accessible AI APIs
• The open-source community

---

KnowSelf — Understand who you are.