EVE AI

Animated AI companion with expressive WALL-E/EVE-style eyes — runs on any device with a browser

---

What is EVE?

EVE is an animated AI companion that lives in your browser. She has expressive eyes inspired by WALL-E and EVE from Pixar — they move, blink, and change emotions based on your conversation.

     ╭──────────────────────────────────╮
     │                                  │
     │     ●  ●      ●  ●              │
     │    ╭────╮    ╭────╮             │
     │    │    │    │    │  ← Eyes     │
     │    │ ·  │    │ ·  │    follow   │
     │    ╰────╯    ╰────╯    your     │
     │                         cursor  │
     │                                  │
     │    ┌──────────────────────┐      │
     │    │ Say something to EVE │      │
     │    └──────────────────────┘      │
     ╰──────────────────────────────────╯

One HTML file. No build step. No dependencies. Just open and talk.

---

Features

Expressive Eyes

• Eyes follow your cursor (or touch on mobile)
• 8 emotions: happy, sad, angry, curious, sleepy, surprised, thinking, love
• Natural blinking at random intervals
• Idle behavior — looks around when you're away, falls asleep after 2 minutes
• Particles burst when you click on the face
• Scanline overlay for that sci-fi feel

AI Brain

• Built-in responses — works offline, no API key needed
• Anthropic Claude support — connect your API key for smarter responses
• OpenAI support — GPT-4o-mini as alternative
• Emotion detection — recognizes feelings in your messages and reacts
• Conversation memory — remembers your last 50 messages

Task Management

• Add tasks: "add task Buy groceries"
• View tasks: "show tasks"
• Complete tasks: "done 1"
• Clear completed: "clear done"
• Native browser notifications for reminders

Memory & Personalization

• Remembers your name across sessions
• Stores preferences ("I like coffee" → remembered)
• LocalStorage persistence — everything survives browser restarts
• Reset anytime: "reset memory"

---

Quick Start

Option 1: Open the file

git clone https://github.com/Anuar-boop/eve-ai.git
open eve-ai/index.html

Option 2: GitHub Pages

Visit the live demo

Option 3: Any web server

npx serve eve-ai/

---

Emotions

EVE reacts to what you say:

You say...	EVE feels...	Eyes do...
"I'm happy!"	Happy	Eyes widen, slight bounce, bright glow
"I'm sad"	Sad	Eyes droop, turn softer blue, eyelids lower
"I'm angry"	Angry	Eyes turn red, eyelids angle inward
"What's that?"	Curious	One eye grows larger, pupils dilate
"I'm tired"	Sleepy	Eyes dim, eyelids half-close
"I love you"	Love	Eyes turn pink, heart-shaped glow
(idle 30s)	Looking around	Pupils drift randomly
(idle 2min)	Sleepy	Falls into idle mode

---

Connect an AI Backend

EVE works offline with built-in responses, but you can connect a real AI:

settings
set provider anthropic
set api key sk-ant-xxxxx

Supported providers:

• Anthropic — Uses Claude Haiku (fast + cheap)
• OpenAI — Uses GPT-4o-mini
• built-in — No API needed (default)

---

Commands

Command	What it does
add task <text>	Add a new task
show tasks	List pending tasks
done <n>	Complete task #n
clear done	Remove completed tasks
my name is <name>	Set your name
I like <thing>	Save a preference
what time is it	Show current time
tell me a joke	Random programming joke
settings	Show configuration options
help	Show all commands
reset memory	Clear all data

---

Run on Any Device

EVE is a single HTML file — it runs anywhere with a browser:

• Desktop — Chrome, Firefox, Safari, Edge
• Phone — mobile browser (eyes follow your touch)
• Tablet — iPad, Android tablet
• Raspberry Pi — Chromium in kiosk mode
• Smart Display — any device with a browser and screen
• Old Laptop — repurpose as a desk companion

Kiosk Mode (Raspberry Pi / Smart Display)

chromium-browser --kiosk --noerrdialogs index.html

Full Screen (any device)

Press F11 or tap the browser's fullscreen option for the immersive experience.

---

Customization

Change Eye Color

Edit the CSS variable at the top of index.html:

:root {
  --eye-color: #00d4ff;     /* Change to any color */
  --eye-glow: rgba(0, 212, 255, 0.4);
}

Color Presets

Theme	--eye-color	--eye-glow
EVE Blue (default)	#00d4ff	rgba(0, 212, 255, 0.4)
WALL-E Amber	#ffb347	rgba(255, 179, 71, 0.4)
Matrix Green	#00ff41	rgba(0, 255, 65, 0.4)
Iron Man Gold	#ffd700	rgba(255, 215, 0, 0.4)
HAL 9000 Red	#ff0000	rgba(255, 0, 0, 0.4)
Portal Orange	#ff6600	rgba(255, 102, 0, 0.4)

---

Tech Stack

• Zero dependencies — pure HTML + CSS + JavaScript
• ~500 lines of code total
• LocalStorage for persistence
• CSS animations for eye movements
• Optional: Anthropic/OpenAI API for smarter responses

---

Related

• claude-enchant — Auto-triggering behavioral rules for Claude Code
• spellbook — CLI skills framework for AI assistants
• claude-agent-kit — Multi-agent orchestration templates

---

License

MIT

_{Built by Anuar AX}