cortex

> cortex

A self-hosted
personal memory assistant.

in: Telegram · voice · web · MCP
out: semantic search · digests · calendar · display
[ Try the demo → ] [ View source ]
AGPL-3.0·TypeScript·Self-hosted

>quickstart

two commands · then localhost:3000
~/dev · bash
$git clone https://github.com/moguls753/cortex.git && cd cortex
$docker compose up -d

Then open http://localhost:3000. A setup wizard handles the rest. See the usage guide for capturing, correcting, searching, and MCP.

>outputs

digest · display · calendar · mcp
output/digestemail

Digest

Daily and weekly email summaries of activity.

output/displaypng · 1872×1404

Display

PNG endpoint for e-ink devices. Today's tasks, events, weather.

output/calendargoogle

Calendar

Dated entries auto-route to the right Google Calendar.

output/mcpstdio · http

MCP

Seven tools for query and capture from any MCP client.

>dashboard

the app itself

Today's digest at the top, a capture bar, recent entries by category, and stats for the week.

app/dashboard localhost:3000

>how it works

stack · flow · tools

flow · architecture

stack

$cortex --stack
runtimeNode.js + TypeScript
webHono
databasePostgres + pgvector
embeddingsOllama · qwen3 (4096d)
llmLM Studio, Ollama, Anthropic, OpenAI, Groq
telegramgrammY
deployDocker Compose

mcp tools

$cortex mcp tools
search_brainsemantic search
add_thoughtcapture from any agent
list_recentfilter by cat, date
get_entryfetch one by id
update_entrymutate fields
delete_entrysoft-delete
brain_statscounts · stalled · activity