git404hub

what is atlas fr?

yelloworangebananaa/atlas — explained in plain English

Analysis updated 2026-05-18

3PythonAudience · developerComplexity · 4/5Setup · moderate

tl;dr

A local-first personal AI assistant that remembers via an Obsidian notes vault, talks by voice or WhatsApp, and writes its own tools when needed.

vibe map

mindmap
  root((Atlas))
    What it does
      Obsidian vault memory
      Voice and WhatsApp chat
      Model failover
    Tech stack
      Python
      Node.js
      Ollama
      Whisper
    Use cases
      Run a private AI assistant
      Journal conversations as notes
      Automate via WhatsApp
    Audience
      Developers
      Privacy focused users

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

what do people make with this?

VIBE 1

Run a private voice and chat assistant that keeps memory in your own Obsidian vault.

VIBE 2

Talk to the assistant over WhatsApp and have it read images, PDFs, and voice notes.

VIBE 3

Configure a fallback chain of AI models so conversations continue if one provider fails.

what's the stack?

PythonNode.jsOllamaWhisper

how it stacks up fr

yelloworangebananaa/atlas0marildo/imago0xdfi/glm-5.2-1m-4x-dgx-spark
Stars333
LanguagePythonPythonPython
Setup difficultymoderateeasyhard
Complexity4/52/55/5
Audiencedevelopergeneralresearcher

Figures from each repo's GitHub metadata at analysis time.

how do i run it?

Difficulty · moderate time til it works · 30min

Needs Python 3.11+, a local or API model backend, and Node.js if WhatsApp support is wanted.

The README does not state a license for this project.

in plain english

Atlas is a personal assistant that runs mainly on your own computer, using a folder of Markdown notes, in the format used by the note-taking app Obsidian, as its memory. It can be talked to by voice or by typing, from a desktop chat window or through WhatsApp, and it remembers past conversations rather than starting fresh each time. If the AI model it is using errors out mid conversation, Atlas automatically switches to a backup model and tells you it did so. The assistant can read images, PDFs, and voice notes, converting each into something the model can use: describing a picture, pulling text out of a PDF, or transcribing spoken audio. Every conversation is saved as a journal entry, and Atlas writes its own permanent notes too, marking them as facts, reusable skills, or lessons from mistakes, then linking each new note to related ones. When it lacks a capability it needs, Atlas can write a new tool for itself following a standard called Model Context Protocol, and the app checks that the tool works before turning it on. Voice input uses a wake word, hey atlas by default, and speech is transcribed locally on your machine, so only the resulting text goes to whichever model you have configured. You can point Atlas at a model running locally through Ollama or LM Studio, so nothing leaves your computer, or at any OpenAI-compatible service. WhatsApp support is set up with a one-time QR code scan and then starts automatically every time Atlas runs, and there is an optional connector for searching files in Google Drive. Getting started means cloning the repository and running a setup script that creates a Python environment, builds the memory vault folder, detects or configures a model backend, and optionally walks through WhatsApp and Google Drive setup. It needs Python 3.11 or newer, and Node.js if WhatsApp is wanted, with every setup step skippable and rerunnable later. Every action Atlas takes is logged to a file for anyone who wants a full audit trail.

prompts (copy fr)

prompt 1
Walk me through running python setup.py to install Atlas and connect a local model.
prompt 2
Explain how Atlas's Model Hierarchy failover works when a provider errors mid conversation.
prompt 3
Help me set up the WhatsApp bridge for this assistant using the QR code pairing step.
prompt 4
Explain how Atlas writes and links its own memory notes in the Obsidian vault.

Frequently asked questions

what is atlas fr?

A local-first personal AI assistant that remembers via an Obsidian notes vault, talks by voice or WhatsApp, and writes its own tools when needed.

What language is atlas written in?

Mainly Python. The stack also includes Python, Node.js, Ollama.

What license does atlas use?

The README does not state a license for this project.

How hard is atlas to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is atlas for?

Mainly developer.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.