⚡ VELLE.AI

Your local AI operating system. Memory, voice, quant engine, productivity suite, journal, habits, goals, achievements — all running on your machine. No cloud. No leash.

🚀 Quick Start Portable EXE

Install Ollama

Download and install Ollama from https://ollama.com

Download a local model

ollama pull qwen3:8b

Launch VELLE.AI Run the portable executable

VELLE-AI-1.0.1-portable.exe

Admin recommended for full system access features

Start using your AI OS The full interface opens instantly

Architecture

velle-ai/
├── server/
│   ├── index.js            # Express + WebSocket server, Ollama, 50+ slash commands
│   ├── memory.js           # SQLite memory manager (conversations, memories, context)
│   ├── commands.js         # System command executor (PowerShell/bash, apps, browser)
│   ├── quant.js            # Kabuneko quant engine (Yahoo Finance, TA indicators)
│   ├── advanced.js         # Reminders, mood tracking, summaries, journal, file search
│   └── productivity.js     # Todos, habits, pomodoro, goals, bookmarks, KB, achievements, insights, briefing
├── public/
│   └── index.html          # Cyberpunk terminal UI + voice engine + chart renderer
├── personalities/
│   └── profiles.json       # 7 AI personality profiles
├── memory/
│   └── companion.db        # SQLite database (auto-created on first run)
├── package.json
└── README.md

Total codebase: ~5,600 lines across 6 server modules + 2,100 line UI

Features

🎭 Personalities

Switch between 7 AI personalities, each with unique system prompts, temperature settings, and accent colors:

ID	Icon	Name	Vibe
`default`	🤖	Default	Helpful and conversational
`sarcastic`	😏	Sarcastic	Dry wit, playful roasts
`evil`	😈	Evil Genius	Bond villain energy
`anime`	⚡	Anime Mentor	Everything is a training arc
`sleepy`	😴	Sleepy	Drowsy but insightful
`kabuneko`	😼	Kabuneko	Sarcastic quant-savvy finance gremlin
`netrunner`	🔮	Netrunner	Cyberpunk street runner

🎤 Two-Way Voice

Speech-to-Text — Browser-native Web Speech API (Chrome/Edge required)

Push-to-talk: Hold mic button or hold Space bar
Click toggle: Tap mic to start/stop listening
Hands-free mode: Continuous listen → send → wait for TTS → listen again
Audio visualizer: 12-bar real-time mic level display
Live transcription: See words appear in the input box as you speak

Text-to-Speech — System voice synthesis

Toggle 🔇/🔊 button to enable
Auto-read toggle in sidebar for always-on
Voice selector with preferred English voices
Strips markdown/emoji before speaking
Chunks long responses for reliable playback
Auto-pauses listening during TTS in hands-free mode

📊 Kabuneko Quant Engine

Full market analysis suite powered by Yahoo Finance + CoinGecko + Finviz. Pure JavaScript, zero Python dependencies.

/market                    — S&P 500, Nasdaq, Dow, futures, crypto, macro
/quote NVDA                — Price, PE, market cap, 52w range, volume
/analyze AAPL              — RSI, MACD, Bollinger, ADX, Sharpe, drawdown, patterns
/chart TSLA 1y             — Canvas chart with SMA50/200, volume, RSI zones
/momentum                  — Multi-timeframe momentum scoring (1/3/6/12m returns)
/dislocate                 — Value dislocation scanner by PE
/backtest AMD              — RSI(30/70) strategy backtest vs buy & hold
/sentiment PLTR            — Finviz headline scraping + keyword sentiment
/moonshot                  — Stealth breakout radar (high vol + small move + near high)

Technical indicators: SMA, EMA, RSI, MACD, Bollinger Bands, ADX, ATR Pattern detection: Golden/Death Cross, RSI extremes, BB breakouts, MACD crossovers, 20-day highs/lows Chart renderer: Canvas-based with price line, gradient fill, dual SMAs, volume bars, RSI with overbought/oversold zones

The LLM auto-enriches responses with live market data when you mention ticker symbols in natural conversation.

📋 Task Manager

/todo add Buy groceries p1 #personal @tomorrow
/todo add Fix login bug p2 #work @today
/todo done 5                — Complete task #5
/todo start 3               — Mark as in-progress
/todo overdue               — View overdue tasks
/todo today                 — Today's tasks
/todo projects              — View all projects with completion counts
/todo stats                 — Total, done, active, overdue, completion rate

Features: 4 priority levels (🔴🟡🟢⚪), project grouping (#tag), due dates (@date), status tracking (todo → doing → done)

🔄 Habit Tracker

/habit add Exercise         — Create a daily habit
/habit add Read 📚          — With custom icon
/habit check 1              — Check in for today
/habit uncheck 1            — Undo check-in
/habit                      — Dashboard with week grid + streaks

Dashboard shows:

✅ 💪 Exercise  🟩🟩🟩⬜🟩🟩🟩 🔥7 (85.3% / 30d)
☐ 📚 Read      🟩🟩⬜⬜🟩⬜🟩 🔥1 (46.7% / 30d)

🍅 Pomodoro Timer

/pomo start Deep work 25    — Start 25-minute focus session
/pomo start                  — Quick start (25 min default)
/pomo stop                   — End session early
/pomo status                 — Time remaining
/pomo stats                  — Today's focus time
/pomo week                   — Weekly focus time

Auto-notifies when timer ends. Logs completed sessions to SQLite.

🎯 Goal System

/goal add Learn Rust                    — Set a goal
/goal ms 1 Read The Rust Book           — Add milestone to goal #1
/goal ms 1 Build a CLI tool             — Add another milestone
/goal check 3                           — Complete milestone #3
/goal progress 1 60                     — Manually set 60% progress
/goal                                   — View all with progress bars

Display:

🎯 #1 Learn Rust █████░░░░░ 50%
   ✅ Read The Rust Book
   ☐ Build a CLI tool

Milestones auto-calculate goal progress percentage.

📓 Journal

/journal write Had a great coding session today
/journal prompt              — Random writing prompt (30 rotating prompts)
/journal today               — Today's entries
/journal                     — Recent entries
/journal streak              — View streak 🔥🔥🔥
/journal weekly              — Weekly reflection (avg mood, word count, themes)
/journal pin 5               — Pin/unpin entry
/journal search coffee       — Search entries
/journal read 12             — Full entry view
/journal delete 3            — Delete entry

Features: Auto-tags entries (work, code, health, money, social, mood, etc.), attaches mood score from mood tracker, streak tracking with longest streak record, 30 rotating writing prompts that avoid repeats.

🧠 Memory & Mood

Memory System:

Say "remember that I like coffee" → saved explicitly
Auto-detects preferences, work info, location, identity
Auto-tags: preference, personal, work, tech, finance, health, location, schedule, goal, project
Auto-importance scoring (name = 9, birthday = 8, goals = 7, casual = 3)
Relevant memories injected into every LLM prompt

Mood Tracking:

/mood                        — Current mood + 7-day trend

Tracks sentiment of every message (positive/negative words + emoji analysis)
Detects triggers: work, money, relationships, health, coding, markets
Trend analysis: improving 📈 / declining 📉 / stable
Injected into system prompt — LLM adapts tone when you're down

⏰ Proactive Reminders

/remind in 10 minutes check email
/remind at 3:00pm meeting with Jake
/remind tomorrow call the dentist
/remind                      — View all pending
/cancelremind 5              — Cancel reminder #5

Supports repeating: every day, weekly, hourly, monthly Fires as: in-chat notification + browser push notification + TTS if enabled Also detects "remind me to..." in natural conversation and auto-sets.

🔖 Bookmarks & 📚 Knowledge Base

Bookmarks — Save important moments from conversations:

/bookmark save The API uses OAuth2 with PKCE flow #auth #api
/bookmark search auth
/bookmark                    — List all

Knowledge Base — Persistent notes, code snippets, links:

/kb add API Keys | sk-abc123-my-key-here
/kb add Git Cheatsheet | git rebase -i HEAD~3
/kb add Portfolio Link | https://velle.dev
/kb search git
/kb read 5

Auto-detects type: 📝 note, 💻 snippet, 🔗 link

📁 Local File Search

/find package.json           — Search by filename
/find TODO                   — Search file contents

Searches: Desktop, Documents, Downloads, Projects, Code, repos, src Searches inside: .js, .py, .md, .json, .ts, .html, .css, .sql, .yaml, and 30+ more extensions Skips: node_modules, .git, build, dist, pycache, venv

🏆 Achievements (25 badges)

Unlock automatically as you use VELLE.AI:

Badge	Name	Requirement
🌟	First Contact	Send first message
💬	Chatterbox	100 messages
🎖️	Veteran	1000 messages
🐘	Elephant	Save first memory
📚	Librarian	10 memories
📓	Dear Diary	First journal entry
🔥	On a Roll	3-day journal streak
⚡	Week Warrior	7-day journal streak
💎	Iron Will	30-day journal streak
✅	Getting Things Done	Complete first task
🏆	Task Master	25 tasks completed
⚙️	Productivity Machine	100 tasks completed
🔄	Habit Former	Create first habit
🍅	Focused	First pomodoro
🧠	Deep Worker	25 pomodoros
🎯	Visionary	Set first goal
🏅	Goal Crusher	Complete a goal
🦉	Night Owl	Message after midnight
🐦	Early Bird	Message before 6am
...	+6 more	...

Achievement toast slides in with gold glow animation on unlock.

💡 Auto-Insights

/insights

Analyzes your data and surfaces patterns:

"work has been a recurring source of stress (4x this week)"
"You created 15 tasks but only completed 3 — consider prioritizing fewer items"
"You haven't journaled this week"
"Your most active time is evening (around 9pm)"
"You have 3 overdue tasks"

☀️ Daily Briefing

/briefing    (or /brief, /morning, /gm)

Generates a complete daily overview:

Current mood + trend
Upcoming reminders
Task stats (active, overdue, completed today)
Habit status with check/uncheck
Goal progress bars
Journal streak
Today's focus time
Achievement progress
AI-generated insights

📊 Dashboard

/dashboard    (or /dash)

Quick aggregate view of all systems in one glance.

REST API: GET /api/dashboard returns JSON with mood, todos, habits, journal, pomodoro, goals, achievements, reminders, memory stats.

💻 System Commands

The LLM can execute system actions:

open_browser — Opens URLs
open_app — PowerShell, calculator, notepad, file manager, terminal
run_shell — Executes PowerShell commands (Windows) or bash (Linux) with blocklist safety
play_music — Opens default music player
system_info — OS, CPU, memory, uptime

All Slash Commands

Category	Commands
Quant	`/market` `/quote` `/analyze` `/chart` `/momentum` `/dislocate` `/backtest` `/sentiment` `/moonshot`
Tasks	`/todo add\|done\|start\|del\|overdue\|today\|projects\|stats`
Habits	`/habit add\|check\|uncheck\|del\|dashboard`
Focus	`/pomo start\|stop\|status\|stats\|week`
Goals	`/goal add\|ms\|check\|progress\|del`
Journal	`/journal write\|prompt\|today\|streak\|weekly\|pin\|read\|search\|delete`
Memory	`/mood` `/summary` `/history`
Reminders	`/remind` `/cancelremind`
Knowledge	`/kb add\|search\|read\|del`
Bookmarks	`/bookmark save\|search\|del`
Files	`/find query`
Overview	`/dashboard` `/briefing` `/achievements` `/insights` `/help`

REST API

All endpoints at http://localhost:3000/api/:

Endpoint	Method	Description
`/api/personalities`	GET	List personalities
`/api/memories`	GET	List memories
`/api/stats`	GET	System stats
`/api/dashboard`	GET	Aggregate dashboard
`/api/briefing`	GET	Daily briefing
`/api/todos`	GET/POST	Task CRUD
`/api/todos/:id/complete`	POST	Complete task
`/api/habits`	GET/POST	Habit CRUD
`/api/habits/:id/check`	POST	Check in
`/api/goals`	GET/POST	Goal CRUD
`/api/goals/:id/milestone`	POST	Add milestone
`/api/journal`	GET/POST	Journal CRUD
`/api/journal/streak`	GET	Streak data
`/api/journal/weekly`	GET	Weekly reflection
`/api/mood`	GET	Current mood
`/api/mood/history`	GET	Mood history
`/api/reminders`	GET/POST/DELETE	Reminder CRUD
`/api/kb`	GET/POST	Knowledge base
`/api/bookmarks`	GET/POST	Bookmarks
`/api/achievements`	GET	All achievements
`/api/insights`	GET	Auto-insights
`/api/pomodoro/start`	POST	Start session
`/api/pomodoro/today`	GET	Today's stats
`/api/files/search?q=`	GET	File search
`/api/quant/market`	GET	Market snapshot
`/api/quant/quote/:ticker`	GET	Stock quote
`/api/quant/analyze/:ticker`	GET	Full analysis
`/api/quant/chart/:ticker`	GET	Chart data
`/api/quant/momentum`	GET	Momentum scan
`/api/quant/sentiment/:ticker`	GET	Sentiment

Tech Stack

Runtime: Node.js 18+
LLM: Ollama (local, any model)
Database: SQLite via better-sqlite3 (WAL mode)
Server: Express + WebSocket (ws)
Frontend: Vanilla JS, CSS custom properties, Canvas API
Voice: Web Speech API (STT) + SpeechSynthesis (TTS)
Market Data: Yahoo Finance v7/v8, CoinGecko, Finviz
Fonts: JetBrains Mono + Orbitron

Zero external AI APIs. Zero telemetry. Everything local.

Name		Name	Last commit message	Last commit date
assets		assets
lib		lib
personalities		personalities
public		public
server		server
.dockerignore		.dockerignore
.gitattributes		.gitattributes
.gitignore		.gitignore
Dockerfile		Dockerfile
README.md		README.md
docker-compose.yml		docker-compose.yml
electron.cjs		electron.cjs
package-electron.json		package-electron.json
package-lock.json		package-lock.json
package.json		package.json
pkg.config.json		pkg.config.json
preload.cjs		preload.cjs

Navigation Menu

Repository files navigation

⚡ VELLE.AI

Architecture

Features

🎭 Personalities

🎤 Two-Way Voice

📊 Kabuneko Quant Engine

📋 Task Manager

🔄 Habit Tracker

🍅 Pomodoro Timer

🎯 Goal System

📓 Journal

🧠 Memory & Mood

⏰ Proactive Reminders

🔖 Bookmarks & 📚 Knowledge Base

📁 Local File Search

🏆 Achievements (25 badges)

💡 Auto-Insights

☀️ Daily Briefing

📊 Dashboard

💻 System Commands

All Slash Commands

REST API

Tech Stack

About

Releases

Packages

Contributors

Languages

Latest commit

History

Folders and files

Repository files navigation

⚡ VELLE.AI

Architecture

Features

🎭 Personalities

🎤 Two-Way Voice

📊 Kabuneko Quant Engine

📋 Task Manager

🔄 Habit Tracker

🍅 Pomodoro Timer

🎯 Goal System

📓 Journal

🧠 Memory & Mood

⏰ Proactive Reminders

🔖 Bookmarks & 📚 Knowledge Base

📁 Local File Search

🏆 Achievements (25 badges)

💡 Auto-Insights

☀️ Daily Briefing

📊 Dashboard

💻 System Commands

All Slash Commands

REST API

Tech Stack

About

Topics

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages