Open-source project
volcengine/MineContext avatar
volcengine/MineContext

MineContext: a screenshot-driven proactive context partner from volcengine

MineContext is your proactive context-aware AI partner(Context-Engineering+ChatGPT Pulse)

5,514 stars410 forksPythonApache-2.0

At a glance

What is it?
MineContext captures your screen, builds local context from it, and pushes summaries, tips and todos back to you. It is an Electron app over a Python backend, Apache-2.0 licensed, and it needs an OpenAI-compatible model endpoint before it does anything useful.
Who is it for?
Adopt MineContext if you want a local-first desktop tool that turns continuous screen capture into daily and weekly summaries, and you are willing to point it at a Doubao, OpenAI or LMStudio endpoint. Skip it if you need Linux support, if you cannot accept that the capture loop is screenshot-only today, or if sending screen content to a hosted model is outside your policy.
Can I use it commercially?
Yes. Apache-2.0 is a permissive licence: you can use, modify and sell software built on it, as long as you keep its copyright and licence notices.
Is it still maintained?
Yes. The repository last received commits 132 days ago.
What is it written in?
Mainly Python, according to GitHub's language statistics.

Answers come from the project's GitHub data, last synced on September 15, 2026, and from our analysis. They are not legal advice.

DEEP OPEN-SOURCE ANALYSIS

The problem MineContext picks: context you never wrote down

Most AI assistants wait for a prompt. MineContext inverts that. According to the README, it uses screenshots and content comprehension to see and understand a user's digital world, then actively delivers insights, daily and weekly summaries, to-do lists and activity records without being asked. The project frames this as a proactive context-aware partner, and the tagline in the repository is "Create with Context, Clarity from Chaos". The target audience is stated directly in a Target User section: people doing work, study and creation who generate a large trail of on-screen activity and want it condensed rather than archived. That is a narrower claim than a general memory layer for agents. MineContext is a desktop application first, shipped as a .dmg for Mac and a setup.exe for Windows from the v0.1.8 release, not a library you import into another agent. The related project listed in the README, volcengine/OpenViking, is positioned as the infrastructure layer for context management, which suggests the team treats MineContext as the end-user surface and OpenViking as the plumbing underneath. If you are looking for a component to embed, MineContext's own README points you elsewhere.

Screenshot capture in, six context types out

The mechanism visible in the material is a pipeline. Capture happens through screenshots. Processing and comprehension happen in a Python backend. Storage is local. Retrieval and consumption feed a front end built on Electron, React and TypeScript, with the backend handling embeddings and a vector database. The README describes the context engineering architecture as supporting the complete lifecycle of multimodal, multi-source data, from capture through processing, storage, management, retrieval and consumption, and says this enables the generation of six types of intelligent context. The four named features map onto that pipeline: effortless collection, proactive delivery, intelligent resurfacing during creation, and the architecture itself. What the material does not give is the shape of those six context types beyond the examples already named (insights, daily and weekly summaries, to-dos, activity records), nor the schema of the vector store, nor which embedding model is used by default. The topics list mentions vision-language-model and embedding-models, so both are part of the stack, but the README does not pin specific models. Treat the six-type claim as a product description rather than a documented interface until you read the backend source.

Local-first storage and the model endpoint decision

Privacy is handled in two layers according to the README. First, local-first: by default all data is stored at ~/Library/Application Support/MineContext/Data. That path is macOS-specific and the README does not give a Windows equivalent, even though a Windows installer is published. Second, model choice: MineContext supports custom model services based on the OpenAI API protocol, and the README states you can use fully local models so that no data leaves your machine. The supported providers named are Doubao, OpenAI, and custom models compatible with the OpenAI API format. The README recommends LMStudio for running local models, and separately recommends the Doubao model when weighing cost against performance, with the API key generated in the Volcengine Ark console. Those two recommendations pull in opposite directions, and the README does not resolve the tension. The practical reading: the local-first storage guarantee is about where files sit, not about whether inference is local. If you configure a hosted endpoint, screenshot-derived content goes to that endpoint. Anyone evaluating this for a workplace with data handling rules should decide the endpoint question before installing, because the capture loop starts as soon as you begin recording.

Getting it running: installer, API key, then the backend build

The quick start has five steps. Installation is a download from the GitHub releases page. Starting from v0.1.5 the README states that MineContext supports Apple notarization, so the quarantine attribute no longer needs to be disabled; older versions required the workaround documented in the 0.1.4 README. After launch you enter an API key, and the README warns that on first run the application installs the backend environment, which may take about two minutes. Then you start recording, and the README's next step is titled "Forget it", meaning the collection is meant to run without supervision. There is a separate backend debugging section. For contributors, the backend has its own install, configuration and run steps, and the frontend has build backend, install dependencies, development and debugging, and application packaging stages. The README does not reproduce the exact shell commands in the portion available here, so if you plan to run the backend standalone rather than through the packaged app, you will need to read the Backend Usage section in full on GitHub. What is clear from the structure is that the shipped app bundles a backend build step at first launch, which is why the two-minute wait exists and why a failed environment install would leave you with a UI and no processing pipeline.

Where the design shows its edges

Three limitations are visible without running anything. The first is platform coverage: the README publishes Mac and Windows builds and gives a macOS data path, with no Linux instructions in the material. The second is source coverage. The tagline promises multi-source multimodal context including documents, images, videos, code and external application data, but the README marks that as future support. Today the described capture path is screenshots. A tool that watches your screen is not the same as a tool that reads your repository, and the gap matters if your work happens in a terminal or an editor where the meaningful state is not what is painted on screen. The third is the model dependency. MineContext does not ship a model. It ships a pipeline that needs an OpenAI-compatible endpoint, and the quality of every summary, tip and todo is bounded by that endpoint. The README's own split recommendation between Doubao for cost and performance and LMStudio for locality means you are making a real trade-off, not accepting a default. There is also no benchmark or evaluation data in the material, so there is no way to judge output quality from the repository description alone.

MineContext against ChatGPT Pulse and Dayflow

The README devotes a section to comparing MineContext with two familiar applications, ChatGPT Pulse and Dayflow. That is the honest comparison set, and the difference that matters is deployment. ChatGPT Pulse is a hosted feature inside a hosted product; you do not choose the model, you do not choose where the derived context is stored, and you cannot point it at a local inference server. MineContext is an application you install, whose data directory is on your disk and whose model endpoint is a configuration choice, including a fully local one via LMStudio. Dayflow occupies similar territory as a screen-activity tool, and the README treats it as a peer rather than a predecessor. The distinguishing claim MineContext makes for itself is the context engineering architecture underneath: the lifecycle from capture to consumption, and the six context types it produces. Whether that architecture produces better output than a simpler recorder-plus-summarizer is exactly the thing the README cannot tell you, because it contains no evaluation results. If you are choosing between these, the decision criteria available from the material are deployment model, platform support and endpoint flexibility, not measured quality.

Licence, releases and what maintenance looks like

MineContext is Apache-2.0. That permits commercial use, modification and redistribution, and it includes an explicit patent grant, which matters for a tool that could end up inside a company workflow. It also means if you fork it and ship a modified version, you carry the notice and attribution obligations that come with the licence. This is a description of the licence text, not legal advice; check the LICENSE file for the operative terms. On releases, the repository shows v0.1.8 dated 2026-01-28, v0.1.7 on 2025-12-25, and 0.1.6 on 2025-11-18. That cadence, roughly one release per month across those three, is the only maintenance signal in the material. The version numbers are still in the 0.1.x range, and the README's own text marks multi-source multimodal support as future work, so the project describes itself as pre-1.0 in substance as well as in numbering. The upgrade path is the installer from the releases page; the README does not describe a migration process for the local data directory between versions, which is worth knowing before you accumulate months of captured context. There is no stated support window and no LTS branch.

Editorial conclusion

Adopt MineContext if you want a local-first desktop tool that turns continuous screen capture into daily and weekly summaries, and you are willing to point it at a Doubao, OpenAI or LMStudio endpoint. Skip it if you need Linux support, if you cannot accept that the capture loop is screenshot-only today, or if sending screen content to a hosted model is outside your policy. Before committing, verify three things in your own environment: that the first-run backend install completes, that your chosen endpoint returns usable results for the context types you care about, and that the data directory at ~/Library/Application Support/MineContext/Data is where you expect it to be on your machine.

Official sources

  1. Issues
  2. License: Apache-2.0
  3. README
  4. Releases
  5. volcengine/MineContext on GitHub
Community notes

Community notes