memex

What is Memex?

Memex is an open-source, local-first AI journal for iOS and Android. It takes a different approach from traditional journaling apps — instead of asking you to sit down and write polished entries, Memex lets you capture life in fragments (text, photos, voice) and uses a multi-agent AI system to organize them into structured cards, build your knowledge base, discover insights, and provide companionship through AI characters.

What "local-first" means here: Your records, cards, and knowledge all stay on your device. There is no Memex server storing your journal. You bring your own LLM provider (OpenAI, Claude, Gemini, DeepSeek, etc.), and your prompts go directly from your phone to that provider — we never see your data. The optional Memex AI service only proxies model requests; it does not store your journal.

[!IMPORTANT] Star Us — you'll get notified of every new release on GitHub ⭐

Features

🤖 AI-Powered Organization

• Memex Agent orchestration: one conversational agent coordinates specialist skills and child agents for timeline cards, PKM filing, schedule updates, knowledge insights, diagnostics, comments, memory curation, media handling, and companion chat.

• Automatically generates the most fitting card for each type of record:
  • Life & productivity (task, routine, event, duration, progress) — record todos, habits, schedules and goals
  • Knowledge & media (article, snippet, quote, link, conversation) — capture notes, references and dialogues
  • People & places (person, place) — record contacts and locations with map preview
  • Data & metrics (metric, rating, transaction, spec sheet) — record measurements, reviews and expenses
  • Visual (gallery) — preserve moments through photos

https://github.com/user-attachments/assets/4da8225e-945c-474c-8540-dc4d7af64a28

• Auto-tagging, entity extraction, and cross-reference linking
• Conversational AI assistant for discussing any card or topic

💡 Knowledge & Insights

• P.A.R.A-based knowledge organization (Projects, Areas, Resources, Archives)
• Insight cards that surface connections across records:
  • Charts (trend, bar, radar, bubble, composition, progress ring) — visualize patterns, distributions and goal progress over time
  • Narrative (highlight, contrast, summary) — surface key conclusions, before/after comparisons, and periodic reviews
  • Spatial & temporal (map, route, timeline) — reconstruct where and when things happened
  • Gallery — visual memory from your photos

https://github.com/user-attachments/assets/5048a9b1-47b2-462a-99f3-6a178e183861

🤝 AI Companion

• Create AI characters with unique personalities that accompany your journaling
• Auto-commentary: Characters react to your new timeline cards — like a friend who's always paying attention
• 1v1 chat: Have real conversations with your character, who remembers your life context from cards and knowledge
• Persistent memory: Characters maintain long-term memory across both comment and chat scenes — they grow with you
• SillyTavern compatible: Import character cards (V2 JSON + PNG) with persona, world book, and example dialogues

📝 Pure Text & Data Freedom

• Effortless Archiving: After AI organization, all your records naturally settle into a series of interconnected Markdown files, making one-click diary and document archiving a breeze.
• Evolve Alongside AI: Why Markdown? Because as AI capabilities rapidly advance, only the purest text records can bridge the gap of time and truly keep pace with its evolution. As LLM models strengthen, these simple records will reliably unlock entirely new interactive experiences and profound insights for you in the future.
• Absolute Freedom to Leave: Zero vendor lock-in. If you ever feel our product no longer meets your expectations, you can one-click export all your records as standard Markdown files and migrate seamlessly to any note-taking app at zero cost.

🔒 Privacy & Local-First

• All data stored locally (filesystem + SQLite)
• App lock with biometric authentication
• No cloud dependency — your data never leaves your device

📂 Storage & Backup

• Supports iCloud Drive, Device storage (custom folder) and App storage
• One-tap full backup / restore

🔗 Multi-LLM Provider Support

Install

• iOS: Download on the App Store
• iOS (China): Download on the App Store
• Android: Download on Google Play
• Early Access (Android APK): You can also download the latest APK directly from GitHub Releases.
• Build from Source: Compile and install from source.

Configure LLM

Memex requires a configured model service to power its AI features. On first launch:

1. Tap the avatar icon → Model Configuration
2. Select your provider (Gemini / OpenAI / Claude / DeepSeek / Memex AI / Ollama / etc.)
3. Enter an API key and base URL, sign in with OAuth, or connect the optional Memex AI service as required by the provider
4. Each agent can be configured with a different model independently

Configure Location Context

Memex can optionally attach your current city, district, and neighborhood context to agent conversations. This uses device GPS only; IP-based location is not used.

1. Open Personal center → Settings → Location.
2. Turn on "Attach current location to chat".
3. Choose a reverse geocoding provider:
   • OpenStreetMap / Nominatim works without an API key.
   • Amap requires an API key.
4. To use Amap, create an application in the Amap Open Platform, enable the Web Service API, copy the key, and paste it into the Amap API Key field.
5. Choose the context granularity and freshness window.

For local live tests of Amap reverse geocoding, pass the key through an environment variable instead of committing it:

AMAP_GEOCODING_TEST_KEY=your_key flutter test test/data/services/geocoding_service_test.dart

🧩 Custom Agent System

Memex isn't just a recording app — it's a platform that lets you build your own AI agents on your phone.

The same skill-host infrastructure used by Memex's internal workflows is available for custom agents. You can wire agents into local events, give them skills and tools, and decide whether they run inline or as background tasks.

What You Can Build

• 🎯 Create agents freely — Give it a name, pick a host type (Pure mode), and a new agent is ready to go.
• ⚡ Event-driven triggers — Choose when your agent activates: after a new timeline card is saved, when a card comment is posted, when a card UI config changes, or when local data changes.
• 🧠 Per-agent LLM configuration — Each agent can use a different model.
• 📝 Custom system prompts — Shape your agent's personality, expertise, and output format with a custom system prompt.
• 📂 Skill — Memex adopts the open Agent Skills standard. Each agent reads