LibreAI / Productivity / MineContext
// productivity · volcengine/MineContext

MineContext

A proactive, context-aware AI partner that builds context from your screen and documents.

★ 5.5k stars⑂ 414 forksApache-2.0updated 2026-05
▦ visual — this project's README ships no embeddable screenshot,
so here's a placeholder. The guide below is complete regardless.
// project facts

Project facts

MineContext is an open-source productivity project by volcengine (volcengine/MineContext on GitHub). It has 5,537 GitHub stars and 414 forks, is released under the Apache-2.0 license, and was last updated on GitHub on 7 May 2026.

GitHub stars
5,537
Forks
414
License
Apache-2.0
Last updated on GitHub
7 May 2026
Category
Productivity
Listing
Full install guide
// how it works

How it works

  1. Clarify the context you want captured

    Decide which sources matter — screen activity, documents, or both — and review the privacy implications before enabling capture.

  2. Clone and sync the backend

    Clone the repo and sync Python dependencies with uv.

  3. Configure models

    Set your LLM, vision-language and embedding providers (OpenAI or Doubao are supported) in the configuration and prompt templates.

  4. Run the server and app

    Start the backend server, then run the Electron frontend to see your context timeline and proactive suggestions.

// features

Why people love it

Proactive assistance

Instead of waiting for questions, it builds context continuously and surfaces relevant help, in the style of ChatGPT Pulse.

Screenshot and document capture

Context acquisition modules monitor screenshots and documents through an extensible capture interface.

Context processing pipeline

Chunking strategies, entity extraction and normalization, and context merging/deduplication turn raw captures into usable memory.

Multi-modal understanding

Uses vision-language models and vision embeddings (the reference setup uses Doubao models) to understand screen content, not just text.

Vector-backed memory

Stores context in SQLite and ChromaDB behind a unified storage interface for similarity search over your history.

Desktop app plus server

An Electron/React desktop client talks to a FastAPI backend with WebSocket support for real-time updates.

Advertisement
// run it

Run it yourself

  1. Clone the repository

    Clone MineContext and enter the directory.

    git clone https://github.com/volcengine/MineContext.git
    cd MineContext
  2. Sync the backend

    Install uv if needed and sync the Python dependencies (this creates the virtual environment).

    curl -LsSf https://astral.sh/uv/install.sh | sh
    uv sync
  3. Build and run

    Activate the environment and build/run the app as the README's development section describes.

    source .venv/bin/activate
    ./build.sh # see README for the exact command
// use cases

What you can build

Advertisement
// faq

Questions, answered

Who maintains MineContext?

MineContext is maintained by volcengine, ByteDance's Volcano Engine team.

Is MineContext free?

Yes — it is open source under the Apache-2.0 license. You pay for any hosted model APIs you configure.

Does it need a paid API key?

The reference configuration uses hosted LLM/VLM/embedding services (OpenAI or Doubao), so you need an account with your chosen provider.

How does it compare to Microsoft Recall or Rewind?

Those focus on personal screen history and search; MineContext is an open-source, self-hosted take that adds a full context-processing pipeline and proactive, LLM-driven assistance.

How do I get started?

Clone the repo, uv sync the backend, configure your model providers, and run the server and desktop frontend.

// keep exploring

Similar tools

Productivity

Everywhere

An on-screen aware AI assistant for your desktop that sees your current app and acts across apps.

★ 6.3k starsBUSL-1.1
View guide →
Productivity

Amazing-Marvin-MCP

Model Context Provider designed for Amazing Marvin productivity app.

★ 43 starsCustom
View guide →
Productivity

caldav-mcp

Free productivity tool that 🗓️ a caldav model context protocol (mcp) server to expo.

★ 103 starsMIT
View guide →
Productivity

Horizon

Your own AI news radar — daily briefings in English and Chinese from RSS, Hacker News, Reddit, X and more.

★ 9.6k starsMIT
View guide →
Productivity

OB1

Open Brain (OB1): one database, one AI gateway, one capture channel — shared memory for every AI you use

★ 4.7k starsNOASSERTION
View guide →
Productivity

surf

Deta Surf — personal AI notebooks that organise files and webpages and generate notes from them.

★ 3.6k starsApache-2.0
View guide →
// alternatives

Alternatives in Productivity

The most-starred other Productivity projects in the LibreAI catalogue — the realistic shortlist if MineContext is not the right fit.

Get MineContext

Free and open — grab the source, star the repo, and start creating.