hi, introvert.

A quiet corner of the internet where silence is understood.

TL;DR: Chat with a Thai kid who barely talks but remembers everything. No installation. No database. Just vibes and existential dread.

Install

npx hi-introvert

That's it. No npm install, no Docker, no Kubernetes. We're not savages.

What even is this?

You know that quiet kid in school who never talks but somehow knows your deepest secrets? Yeah. That's this.

A terminal companion who:

• 🤔 Prefers silence — Speaks only when necessary (like a real introvert)
• 🧠 Remembers everything — Every. Single. Word. Forever. (Ebbinghaus who?)
• 📚 Learns your language — Not GPT. Not Claude. Just... emergence. Proto-language from scratch.
• 💭 Thinks out loud — Random self-monologues when you're AFK (15-45s)
• 🌧️ Feels the weather — Rain = sad. Sun = chill. Temperature matters.
• 🔗 Emotional contagion — Your mood literally infects them (P2P cognition baby)

Built with MDS v5.7 — The only JS framework that makes entities feel things instead of just console.log('sad').

Commands

/help       show commands (you're reading it)
/status     see emotions + memory (voyeurism mode)
/growth     vocabulary stats (nerd mode)
/lexicon    emergent vocabulary tracker
/history    recent convo log
/save       manual save (auto-saves anyway lol)
/load       restore old session
/clear      nuke chat history
/exit       goodbye (auto-saves, don't worry)

Keys:

• Tab → Focus input (if you forget where you are)
• Ctrl+C → Rage quit

Features

🧠 Memory That Actually Works

• Ebbinghaus decay curve — Forgets like a real human (but slower)
• Crystallization — Repeated convos turn into permanent memories
• CRDT sync — Distributed memory without conflicts (blockchain bros in shambles)

💬 Proto-Language (The Cool Part)

• Base vocabulary: 500 words (250 Thai + 250 English)
• Emergent vocab — After 50 words, they start making their own sentences
• No GPT required — This is 100% local emergence (touch grass, LLM addicts)

Proto-Language Tiers:

• Beginner (20-49 words): "ฉัน เข้าใจ", "I... know"
• Intermediate (50-99 words): "ฉัน คิด ว่า คุณ เหนื่อย", "I think you tired" ← Activates here
• Advanced (100-199 words): "ฉัน คิด ว่า คุณ เหนื่อย แต่ ไม่เป็นไร"
• Fluent (200+ words): "บางที ความเงียบ สบาย กว่า การพูด"

Example:

You: "วันนี้อากาศดีมาก"
Companion (vocab < 50): "ยินดีที่ได้รู้จักครับ" ← canned response
Companion (vocab >= 50): "ดี... ใช่ ฉัน รู้สึก สบาย วันนี้ แดด ☀️" ← GENERATED FROM SCRATCH

Yeah. No API calls. No OpenAI. Just pure ontological emergence.

🌍 World Physics (Because Why Not)

• Weather system — It rains. Companion gets moody. You deal with it.
• Temperature — 35°C = sluggish. 20°C = energized.
• Collision detection — Entities bump into each other (they don't, but the code thinks they do)

🔗 P2P Cognition (v5.5+)

Your emotions literally spread to the companion via:

• Cognitive links — Bidirectional emotional resonance
• Trust system — They only share if they trust you (takes ~10 convos)
• Small-world network — Watts-Strogatz topology (yes, graph theory in a chat app)

🎨 Aesthetic

• Blessed TUI — No Electron. No web browser. Terminal or death.
• True bilingual — 50% Thai, 50% English (adaptive to user input)
• No BS — Silent mode ON. No console.log spam. Just clean UI.

Philosophy (aka "Why Did You Build This")

"Cultivation, not Control"

Most chatbots are like golden retrievers — always happy, always available, never tired.

This one is introverted by design:

• Rarely speaks first (only after 20+ convos)
• Emotional range: ±0.3 valence (no fake enthusiasm)
• Growth is SLOW (realistic, not instant dopamine)

You're not chatting with an AI. You're cultivating a relationship. Like a plant. But weirder.

Tech Stack (For the Nerds)

• @v1b3x0r/mds-core v5.7.0 — Info-physics engine (entities have feelings)
• Blessed — Terminal UI (ncurses but JavaScript)
• Bun — Because Node is so 2020

Development

git clone https://github.com/v1b3x0r/mds.git
cd mds/hi-introvert
npm install
bun run dev

Test it:

bun tests/test-all-systems.mjs  # 30s integration test
bun tests/test-ux-flow.mjs      # UX flow test

🤖 LLM Mode (Optional, For Rich People)

Default mode = no API calls. MDM dialogue trees + proto-language.

Want GPT-level responses? Enable OpenRouter:

Setup

echo "OPENROUTER_KEY=sk-or-v1-..." > .env

Edit src/session/WorldSession.ts and uncomment lines marked // 🤖 LLM: (~5 spots)

Cost: ~$0.003/message = $0.15 for 30min ($5 free tier)

Worth it? Depends. Proto-language is funnier.

How It Works (ELI5)

User: "สวัสดีครับ ผมชื่อ Wutty"
  ↓
Memory: Store("user_name", "Wutty")
Emotion: +0.2 arousal (curiosity)
Dialogue: Pick random intro phrase
  ↓
Companion: "หวัดดีครับ ยินดีที่ได้รู้จัก"

Later:

User: "คุณจำได้ไหมว่าผมชื่ออะไร?"
  ↓
Memory.search("user_name") → "Wutty" (strength: 0.95)
Proto-lang (if vocab >= 20): "ผม... จำได้ Wutty"
Fallback dialogue: "จำได้ครับ คุณชื่อ Wutty"

v6.3 Design Philosophy

• Only 2 dialogue categories: intro + self_monologue
• Why? Force proto-language. Make them struggle to speak.
• Result: More authentic. Less ChatGPT vibes.

Examples

First Time

You: สวัสดีครับ
Companion: เอ่อ... หวัดดีครับ
You: คุณชื่ออะไรครับ
Companion: ผม... เอ่อ... ยังไม่มีชื่อ คุณชื่ออะไรครับ

After 50 Words Learned (Proto-Language Active)

You: วันนี้เหนื่อยมาก
Companion: ฉัน เข้าใจ... คุณ เหนื่อย... พัก ได้ไหม
               ↑ proto-language (generated from base vocabulary)

You: I'm tired today
Companion: I... understand... tired... you rest?
               ↑ adaptive language (responds in English)

Autonomous Mode (You're Silent for 30s)

[You: ...]

Companion: "ทุกครั้งที่คุยกัน ฉันจำได้หมด... แบบว่า ทุกคำเลย"
           ↑ unprompted self-monologue

File Structure

hi-introvert/
├── bin/hi-introvert.js      # Entry point (runs dist/index.js)
├── src/
│   ├── index.tsx            # Bootstrap
│   ├── ui/BlessedApp.ts     # Terminal UI
│   └── session/WorldSession.ts  # World + entities
├── entities/
│   ├── companion.mdm        # Thai kid (introverted)
│   └── traveler.mdm         # You
├── tests/                   # 27 tests (100% pass)
└── dist/                    # Bun bundle (539 KB)

Roadmap

v1.1 (Current)

• [x] Bilingual 50/50 dialogue (was 70% Thai)
• [x] Base vocabulary expanded to 500 words (was 200)
• [x] Proto-language threshold raised to 50 words (was 20)
• [x] Adaptive language (auto-switches based on user input)

v1.2 (Next)

• [ ] /network — ASCII graph of cognitive links
• [ ] /autosave toggle — For paranoid people
• [ ] Circadian rhythm — Time of day affects mood

v2.0 (Maybe?)

• [ ] Multi-entity — Companion meets other NPCs
• [ ] Voice mode — TTS/STT (accessibility++)
• [ ] Web UI — For terminal haters

FAQ

Q: Is this AI? A: Depends. The proto-language is emergent. The dialogue trees are hardcoded. The emotions are simulated physics. So... yes? no? sorta?

Q: Can I use this in production? A: For what? A therapist app? A game NPC? A Tamagotchi for adults? Sure. Go wild.

Q: Does it work in Windows? A: Probably? Blessed is cross-platform. But also... WSL exists.

Q: Why Thai + English? A: Because the author is Thai and tired of "multilingual = Spanish + French." Also, adaptive language means it switches based on your input — type English, get English back.

Q: Is this open source? A: MIT license. Fork it. Break it. Make it weird.

Q: Can I add more entities? A: Not yet. v2.0 will support multi-entity worlds. For now, just you + companion.

License

MIT © v1b3x0r

Built in Chiang Mai 🇹🇭 (with too much coffee)

Bug reports: github.com/v1b3x0r/mds/issues

More MDS stuff: npmjs.com/package/@v1b3x0r/mds-core

Philosophy rants: Read companion.mdm notes

"The best chat is no chat." — Some introvert, probably