Atlas
unlistedby Miguel Verรญssimo
Local-first second brain. 15 professional profiles, 15 AI tools, ECharts analytics, course manager, knowledge graph, 100% local via Ollama.
โ
1 starsUpdated 3mo agoMIT
๐ Atlas
Your Iron Man HUD for Obsidian โ local-first AI second brain.
"It doesn't forget. It summarizes. It reports. It asks. It teaches. Voice. Vision. Memory."
โญโโโโโโโโโโโโโโโโโโโฎ
โ โฏโโฏโโฏโโฏโโฏโโฏ โ
โ โฑ ATLAS HUD โฒ โ
โ โฒ โโโ
โโ
โโ โฑ โ
โ โฒ___________โฑ โ
โฐโโโโโโโโโโโโโโโโโโโฏ
local ยท private ยท adaptive ยท proactive
๐ What is Atlas?
Atlas turns your Obsidian vault into a proactive AI co-pilot โ a second brain that listens, watches, remembers, and acts.
Speak to it. Type to it. It creates documents. It categorizes. It opens files. It cites real notes. It generates weekly reports. It detects patterns across hundreds of meetings. It runs 100% on your machine via Ollama โ or pluggable into 9 cloud providers (OpenAI / Anthropic / Google / Mistral / xAI / OpenRouter / Groq / DeepSeek / Cohere) with per-feature cost tracking + budget gates.
Built for 15 professional profiles out of the box: engineering, product, design, marketing, sales, coaching, HR, finance, legal, healthcare, education, research, student, manager, hybrid.
โก Highlights
| Feature | What it does |
|---|---|
| ๐๏ธ Jarvis voice mode | Full-screen modal with animated orb (cyan glow + breathing). Push-to-talk creates entities. "Create person Joรฃo, direct-report, team Payments" โ registered in your KG. |
| ๐ฌ Chat with tool calling | Agent mutates your vault: create person/system/product/role/course, schedule meetings, compose emails, set reminders, create_note with auto-categorization + auto-open. |
| ๐ฅ Frictionless capture | Cmd+Shift+A from any app โ modal. Natural-language dates ("friday 14h"). Voice via whisper.cpp + Web Speech fallback. |
| ๐ช Cockpit popout | OS-level Electron window โ multi-monitor, always-on-top toggle, Iron Man HUD aesthetic. Voice + chat strip persistent. |
| ๐ฅ Vault Importer Wizard | Migrate 100-1000 notes from external vaults / Notion / Roam / Logseq with auto-detection (UUID strip + frontmatter conversion) + 6-stage review pipeline + cost <$0.10 per 500 notes. |
| ๐ Knowledge Graph | People, projects, themes, systems, products, courses, roles auto-extracted via LLM with citation whitelist (real paths validated against vault). |
| ๐ฆ Smart routing | complexityHint: simple|complex auto-downgrades SonnetโHaiku, GPT-4oโmini for 12-16ร cheaper calls without quality loss. |
| ๐ ECharts analytics | Heatmap (365-day grid), Trends (KG growth + sessions/week + themes), KG Graph (force-directed Cytoscape), Mood radar from daily logs. |
| ๐ Course manager | Track courses, modules, certificates + spaced repetition flashcards (FSRS-4.5) + Anki Mobile sync. |
| ๐ฉบ Health dashboard | 7-system live check (Ollama / Cost / Router / LLM / KG / Whisper / Cloud) โ visible in Settings. |
๐ Bilingual & Customizable
- PT-BR + EN โ runtime switch via
Settings โ Atlas โ ๐ Idioma da interface. Re-renders without reload. - ~354 i18n keys covering ~99% of UX strings.
- Color theme picker (cyan / indigo / orange / rose / forest) โ applied dynamically via CSS variables.
- 15 professional profiles with adaptive toolset, templates, frameworks, and KPIs.
๐จ Visual System โ Iron Man HUD aesthetic
- Color palette: cyan
#00e5e5ร indigo#6366f1gradients - Backdrop: deep navy
#050B18 โ #000510cosmic gradient - Animations: GSAP slide-ins, breathing logo, orb pulses, sonar rings, particle systems (200+ with glow + trails + parallax)
- Audio: synthetic Web Audio FX (ding / whoosh / success / error) + Piper TTS for voice output
- Premium polish: cards with hover lift + accent line, message bubbles with bouncy slide-in, mic button red pulse during recording, send button gradient with hover scale
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ โโโโ cyan.glow โโโโ indigo.flow โโโโ โ
โ โโโ
โโ voice.wave โโโ
โโ โ
โ โ โ โ โ jarvis.thinking โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
๐ ๏ธ Capabilities Matrix
๐ Document creation (chat OR voice)
"Create a daily log for today"โ02_Daily/2026-05-03.md+ auto-open"Generate weekly report on Q2 sales"โ04_Reports/weekly/2026-05-03-q2-sales.md(slugified)"Create ADR about adopting Postgres"โ09_Knowledge/adrs/...md- 12 noteTypes: daily / 1on1 / meeting / weekly-status / project / raid / incident / adr / paper / course / knowledge / inbox
๐ค 14 agentic tools
| Tool | Mutates |
|---|---|
create_person / create_system / create_product / create_role / create_course | Knowledge Graph entities |
create_note โญ | Markdown file + folder + auto-open |
create_action_item / create_reminder | Hub + Reminders tab |
schedule_meeting | Meeting note with attendees + agenda |
compose_email | SMTP send via nodemailer |
report_person_sessions | Aggregated person report |
aggregate_systems_by_period | System mentions across timeframe |
forget_person (RTBF) | LGPD-compliant deletion |
index_vault | Embeddings + KG refresh |
switch_profile | Adaptive toolset swap |
๐๏ธ Voice mode (Jarvis)
- Whisper.cpp local (auto-detect Homebrew paths) OR Web Speech API browser fallback
- Push-to-talk via Spacebar in Jarvis modal
- 14 voice commands: capture, daily, status, lembrar, criar pessoa/sistema/produto/cargo/curso/nota/relatรณrio, mandar email, agendar reuniรฃo, trocar perfil
- Piper TTS for assistant responses (toggle ๐ in chat)
๐ฅ Vault Importer Wizard
- 6 stages: Scan โ Classify (heuristic, zero-LLM) โ Extract (LLM only if confidence<0.7) โ Categorize โ Move (preserves backlinks via fileManager.renameFile) โ Index
- 7 review screens: source picker โ categories table โ people detected โ systems detected โ tags + themes โ folder mapping โ final config
- Source format auto-detection: Notion (UUID strip + frontmatter conversion) / Roam (JSON parser) / Logseq (journals/pages) / Obsidian
- Conflict resolution: filename suffix
-imported-N+ broken-link comments + archive on collision - Cost ~$0.10 for 500 notes with cloud Haiku routing
๐ฆ Smart cost routing (cloud opt-in)
- 9 providers: OpenAI / Anthropic / Google / Mistral / xAI / OpenRouter / Groq / DeepSeek / Cohere
- Per-task routing:
chat / reasoning / embedding / vision / summarization / extraction complexityHint: simple โ Haiku/mini, complex โ Sonnet/Opus- Per-feature cost tracking (
feature: "kg.extractor" / "agent.chat") with daily/monthly budget + soft warn + hard cutoff - Spend dashboard with ECharts breakdowns by day/provider/feature/task
๐ Privacy & security
- 100% local by default via Ollama
- Coach mode isolation (separate vault scope, audit-friendly)
- Audit log SHA-256 hash chain in
.atlas/audit.jsonl - Light encryption for SMTP password / Telegram token
- No telemetry โ zero outbound network calls without explicit user opt-in
๐ฌ Onboarding & Tutorials
- First-run wizard (11 steps): language picker โ welcome โ profile multi-select (15 options) โ workflow โ goals โ vault structure โ Ollama setup โ email โ telegram โ done
- Auto-launches interactive tutorial after onboarding completes (driver.js-style highlights)
- 5 guided tours: First steps ยท One-on-one ยท Weekly report ยท Flashcards ยท Knowledge Graph
- WhatsNew modal showcases recent features per version
- Smoke test + self-test diagnostic built-in (Cmd+P โ Atlas: Self-test)
๐ฆ Install (BRAT โ works today)
The fastest way โ works while we wait for Obsidian's official Community Plugins approval:
- Install BRAT plugin:
Settings โ Community Plugins โ Browse โ BRAT - Enable BRAT, then
Cmd+P โ "BRAT: Add a beta plugin to update with frequent updates" - Paste:
https://github.com/MisterM-Code/atlas-plugin - Click Install. Atlas will auto-update on each new release.
After install
Cmd+P โ Atlas: Setup vault structureโ creates the folder skeleton (02_Daily/,03_Meetings/, etc.)- Install Ollama and pull
qwen2.5:7b+bge-m3:ollama pull qwen2.5:7b ollama pull bge-m3 - Restart Obsidian โ onboarding wizard auto-opens
๐ฅ๏ธ Hardware
| Tier | RAM | Recommended models |
|---|---|---|
| Light | 8โ16 GB | qwen2.5:7b + bge-m3 (default) |
| Heavy | 16โ32 GB | qwen2.5:14b + bge-m3 + bge-reranker-v2-m3 |
| Cloud | any | Anthropic Haiku (cheap) or OpenAI mini |
Atlas detects available RAM at onboarding and recommends the best stack.
โจ๏ธ Default hotkeys
| Hotkey | Action |
|---|---|
Cmd+Shift+J | Open Jarvis (full-screen voice mode) |
Cmd+Shift+A | Quick capture (works from any app) |
Cmd+K | Atlas Spotlight (universal launcher) |
Cmd+Shift+H | Atlas HUD overlay |
Cmd+Shift+R | Reasoning modal (chain-of-thought) |
| Spacebar (in Jarvis) | Push-to-talk |
๐งฌ Architecture
User input (text/voice)
โ
Intent Dispatcher (regex + KG entity lookup, ZERO-LLM first)
โ
confidence โฅ 0.85 โ DIRECT execute tool
confidence < 0.85 โ Orchestrator
โ
Researcher (cheap LLM) + Writer (quality LLM) split
โ
14 agentic tools โ mutate vault + KG
Built on:
- TypeScript + esbuild + zod schemas
- Ollama local LLM + 9 cloud providers via
LLMServicefaรงade - Hybrid retrieval: BM25 + dense embeddings + bge-reranker
- FSRS-4.5 spaced repetition
- Cytoscape.js + ECharts for analytics
- Whisper.cpp + Piper TTS for voice
- chrono-node for natural language dates
๐ค Credits & Inspirations
- Obsidian โ the foundation
- Ollama โ local LLM runtime
- Whisper.cpp โ local speech-to-text
- Piper TTS โ local text-to-speech
- Apache ECharts โ analytics
- Cytoscape.js โ graph visualization
- chrono-node โ natural date parsing
- Tony Stark โ for the aesthetic ๐ฆพ
๐ License
MIT โ see LICENSE.
Atlas v0.81.0 โ built with โค๏ธ + ๐ by @MisterM-Code
If you find Atlas useful, โญ star the repo โ it helps a lot.
For plugin developers
Search results and similarity scores are powered by semantic analysis of your plugin's README. If your plugin isn't appearing for searches you'd expect, try updating your README to clearly describe your plugin's purpose, features, and use cases.