The open source
AI memory agent

Free to use, fully local, or connect any model. TIMPs remembers what matters, retrieves context when relevant, and evolves with every conversation.

$ curl -fsSL https://raw.githubusercontent.com/Sandeeprdy1729/timps/main/install.sh | bash

Be the first to know when we release new features.

Learn more
timps — interactive memory session
$timps cli --user-id 1 --provider openai
✓ PostgreSQL connected
✓ Qdrant vector store ready (1536-dim)
────────────────────────────────────────
you > I'm working on a React app with TypeScript and Zustand for state management
timps › Got it! I'll remember your stack. React + TypeScript + Zustand sounds solid.
[REFLECTION stored · importance: ⭐⭐⭐⭐⭐ · id: #42]

you > !blame React
🔍 Found 2 memory item(s) matching "React":
[42] REFLECTION ⭐⭐⭐⭐⭐ — React app with TypeScript + Zustand
[38] EXPLICIT ⭐⭐⭐ — prefers functional components over class components

you > !audit
📋 Last 5 memories · retrieved: 23 total across 3 projects
[42] [41] [38] [31] [12]

you >
What is TIMPs?
An AI agent that actually
knows you — across
every session.
The open source AI memory agent

Built in the open, used by developers who care about their tools actually remembering context.

Fig 1.
14
Memory fields per stored fact
Fig 2.
3
Model providers supported (OpenAI, Gemini, Ollama)
Fig 3.
2×
Dual search — SQL + vector semantic retrieval
Architecture
User → TUI / CLI / Web / REST API
│
▼
Core Agent ← system prompt + tool definitions
│
├── Planner break goal into steps
├── Executor run tools (file, web, search)
└── Reflection extract + score memories post-turn
│
▼
Memory System
├── ShortTermStore rolling context window (token budget)
├── LongTermStore PostgreSQL (14-field schema, ILIKE search)
└── VectorStore Qdrant cosine similarity (1536-dim embeddings)
Memory Commands
!blame
<keyword>
Search all stored memories for a keyword. Runs dual SQL + vector search and shows importance scores and retrieval counts.
!forget
<keyword>
Preview matching memories before deletion. Requires confirmation. Atomically removes from PostgreSQL and Qdrant simultaneously.
!audit
View last 10 stored memories with full metadata — type (EXPLICIT / REFLECTION), importance stars, created timestamp, retrieval count.
Built for privacy first
Your context
stays on your
machine.
FAQ
TIMPs (Trustworthy Interactive Memory Partner System) is an open-source AI agent with persistent memory. It stores facts, preferences, goals, and reflections from your conversations in PostgreSQL and Qdrant, then retrieves relevant context automatically in future sessions.
No. TIMPs works fully locally using Ollama. If you want to use GPT-4 or Gemini, add your key to the .env file. Switch providers anytime with the --provider flag.
After each turn, TIMPs reflects on the conversation and extracts facts with an importance score (1–5). Facts are stored with 14 metadata fields in PostgreSQL and as vector embeddings in Qdrant. Future queries trigger dual-mode retrieval: SQL keyword matching + cosine vector similarity.
Launch with --mode ephemeral and nothing is persisted. The session exists only in RAM. Use it for sensitive conversations, debugging, or one-off queries you don't want stored.
Yes. TIMPs is released under the MIT license. Every line of the agent, memory system, and API is available on GitHub.
Yes. The web chat interface connects to your local TIMPs server running on localhost:3000. Run npm run server, then open the web UI. All !blame, !forget, and !audit commands work in the browser too.