Import that ends in Markdown
Drop in a web page or a PDF. The agent converts it to Markdown, gives it a title and files it where it belongs.
ino
Open source · Self-hosted · Obsidian-compatible
Your Mind,
Organized.
Your notes live in a Markdown vault on your own server, reachable from any browser with sync built in, while an AI agent keeps them filed, tagged and linked. Mino is an open-source Obsidian alternative, and you bring the model key. Join the list and you get one email when it launches.
MOC-Architecture
- Linked to: `System-Design.md`, `Scalability.md`, `Infra-Choices.md`
- Tags: #core-systems #backend #planning
Agent update:
• Added backlinks between related architecture notes.
• Created section summaries for fast retrieval.
• Suggested two missing documents from recent imports.
What is Mino AI?
Mino (mino.ink) is an open-source alternative to Obsidian that runs on your own server. The vault stays a folder of plain .md files, so Obsidian or any editor can open it. An AI agent works inside the notes: it files what you import, tags it, links it, summarises it and retrieves it. You bring the model key.
The server is the sync. Reach the same vault from any browser through the mino.ink relay or your own tunnel, instead of paying for a sync service or syncing a folder through someone else's cloud. Both are encrypted connections to your server, and your notes never live on mino.ink.
Every note operation is an HTTP route with an X-Mino-Key header, plus an MCP bridge, so Cursor, Claude or a script works in the same vault. Android and iOS clients wrap the same vault and are in internal testing. Mino is an independent project, not affiliated with Obsidian or with other products that share the name. More about Mino.
WHAT IT DOES
Built for people with too many notes
What the server and the agent do, one card each.
The agent keeps it sorted
It reuses the tags you already have, links a note to related ones, writes summaries and keeps the folder tree shallow.
Search, then answers
Full-text search works with no setup. Add embeddings and it searches by meaning; answers arrive with the notes they came from.
One container, your files
The vault is a folder of plain .md files on a server you run, so Obsidian or any editor can open it too. No account and no export step.
Built around the agent
Every note operation is an HTTP route with an X-Mino-Key header, plus an MCP bridge, so the agent and your own tools work in the same vault.
Reach it from anywhere
Your server is the sync. Open the vault from any browser through the relay or your own tunnel; the Android and iOS builds are in development.
HOW IT WORKS
Follow one note from capture to search
Capture is the only step you have to do. The agent handles the filing; search handles the rest.
01
Capture it
Write Markdown, drop in a web page, import a PDF. The note is a plain .md file from the moment it lands.
02
The agent files it
It reads the note, reuses your existing tags, links it to related notes and moves the file where it belongs.
03
Find it again
Full-text search is on by default. With a provider configured it turns semantic, and the agent answers from your notes.
THE AGENT
What the agent actually does
It works inside the vault, proposes a place for what you save, and reports every change it makes.
✦
I found 3 notes about "architecture" that aren't linked. Want me to connect them and write an index note?
Yes, and tag them with #core-systems too
T
✦
Done:
• Linked all 3 architecture notes
• Created
• Added
• Found 2 more related notes in /Research
• Linked all 3 architecture notes
• Created
MOC-Architecture.md• Added
#core-systems to each• Found 2 more related notes in /Research
LAUNCH ANNOUNCEMENT
Get one email when Mino launches.
No newsletter and no sequence: one message at launch, and one click removes you.
You don't have to wait for it. The repository, the docs and the web workspace are public today, and the container runs from the compose file.
UNDER THE HOOD
The stack, in eight parts
What each piece does, and why it is there.
BUN
Server Runtime
HONO
API Framework
NEXTJS
Web App
EXPO
Mobile builds in testing
SQLITE
Index + FTS5
YJS
CRDT Sync
MCP
Agent Protocol
MD
Source of Truth
OPEN SOURCE
Built in the open
The server, the web app and the mobile clients are in one public repository. The reference deployment is a compose file you can read before you run it.
$
docker compose up -dFAQ
What people ask before signing up
What Mino is, what it costs, and what the list is for.
What is Mino AI?
Mino is an open-source Obsidian alternative that runs on your own server. Your notes are plain .md files in a vault, and an AI agent files, tags, links and retrieves them. There is no Mino account.
Can I run Mino today?
Yes. The repository is public: clone it, run the container with the compose file, and connect a client. The list is only a launch announcement, for people who would rather not run a server yet.
How is it different from a Markdown editor with a chat panel?
A chat panel only knows the note you have open. Mino's agent works on the whole vault: it files what you save, keeps links between notes coherent, and answers across everything. The same operations are an HTTP API and an MCP bridge, so Cursor or Claude can read and write the vault.
Do I need to create an account?
No. There is no Mino account and no central login. You deploy the server with Docker or a Portainer stack, then link a client with a relay code or a server URL plus API key. That is also why there is no 'mino login' page.
What happens after I join the waitlist?
You get one email when Mino launches, and nothing else. No newsletter, no sequence. The confirmation you receive now carries a one-click unsubscribe if you change your mind.
Is Mino free?
The core is open source and free to self-host. You supply the server and your own model API key, so you pay that provider directly. The agent stays disabled until you configure a provider, model and key; search works without one.
Is there a mobile app?
The web workspace runs today from the repository. Android and iOS builds are in development and will wrap the same vault; the list is only a launch announcement.