Persistent memory for AI agents doing literature review with your taste.
Project description
(-o-) alit
Your agent forgets every paper it's ever read.
alit is a local knowledge base for AI agents doing literature review. One agent reads 50 papers and stores structured summaries, citations, and reading status. The next agent — or the same agent next week — queries that knowledge instantly.
The agent builds the knowledge. You set the taste. Knowledge compounds.
pip install agent-lit → zero dependencies, SQLite-only, works with any coding agent.
The core loop
alit taste "vision-language grounding, embodied AI" # you set direction
alit recommend 5 # agent picks what to read
alit summarize <id> --l4 "..." --model claude # agent stores findings
alit ask "what approaches exist for X?" --depth 2 # agent synthesizes
Run alit --help for the full command list (25 commands for search, import, export, citations, and more).
What alit does and doesn't do
| alit | The agent | |
|---|---|---|
| Stores papers, summaries, citations, taste | ✓ | |
| Ranks recommendations (PageRank + taste + recency) | ✓ | |
| Retrieves context for synthesis | ✓ | |
| Persists across sessions | ✓ | |
| Reads papers | ✓ | |
| Writes summaries | ✓ | |
| Decides what to cite | ✓ | |
| Answers research questions | ✓ |
alit stores and retrieves. The agent thinks. You set the taste.
Setup
pip install agent-lit # or: uv add agent-lit
Spin up Claude Code, opencode, Cursor, or whatever you use, then prompt:
Set up alit for literature review in this project. See https://github.com/Zhou-Hangyu/alit
From there:
Find and add the top 10 papers on vision-language grounding from the last 2 years.
Read the next 5 recommended papers and summarize each one.
What does the literature say about cross-modal attention mechanisms?
How it works
.alit/
├── papers.db ← one SQLite file, entire knowledge base
└── pdfs/ ← auto-downloaded from arXiv
No servers. No API keys. No vector databases.
Update
pip install --upgrade agent-lit
Under the hood
- Search: BM25 via SQLite FTS5
- Ranking: PageRank on citation graph (pure Python)
- Recommendations: PageRank + recency + taste matching
- Synthesis: multi-stage funnel retrieval (~5K tokens to query 10K papers)
- Enrichment: arXiv API (batched) with Semantic Scholar fallback
- Backward compatible: schema auto-migrates on upgrade
License
MIT
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file agent_lit-0.5.0.tar.gz.
File metadata
- Download URL: agent_lit-0.5.0.tar.gz
- Upload date:
- Size: 43.0 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.8.8
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
8845876bfdc4b43da6267578887aa3f48218a9457b5f521384200f8f246be126
|
|
| MD5 |
0721ac81edaf43a200b7d12070ffdfae
|
|
| BLAKE2b-256 |
125b87e9f3c896556cec2cdf0eb6de72eeda96b1b79d7f1271e6bd0ffa340b85
|
File details
Details for the file agent_lit-0.5.0-py3-none-any.whl.
File metadata
- Download URL: agent_lit-0.5.0-py3-none-any.whl
- Upload date:
- Size: 39.6 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.8.8
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
1c015e699d77c4550d639af8f13532d993610ff2095b871540ce4147bbffcb8e
|
|
| MD5 |
fb68b6d76c60df0be0c2fe6c8ced99b4
|
|
| BLAKE2b-256 |
63129f450a8d2ba3a91039b76a208b624e6e1679e79054c391546725cebc68f0
|