Skip to content

Latest commit

 

History

139 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Mimir — open-source AI research workspace

Mimir

The research-lifecycle copilot inside DeepSeek Harness:
literature · experiments & remote GPUs · figures · LaTeX writing → compile → preview · group-meeting decks — one workbench, driven by your agent.

CI npm: dsh-mimir Website License: MIT

English · 中文 · Website

What it is

Mimir is a single npm package (dsh-mimir) that plugs into dsh and gives you:

  • Eight-view web workbench (sidebar toggle → overlay, dark/light, 中/EN): Overview pipeline & stats · Paper Overleaf-style LaTeX studio (edit → compile → PDF preview, one-click AI fix) · Library arXiv + web search, AI relevance scoring, fullscreen PDF reader · Experiments metric charts, one-click paper figures · Figures upload/organize/insert into the paper · Meetings one-click group-meeting PPT (real paper figures + optional AI illustrations) · Servers GPU fleet probes + remote jobs · Ledger humanized research journal — idea evolution auto-captured into a worktree, six-perspective digest capsules, one-click progress report
  • Agent tools & slash commands: /research-idea /research-plan /research-review /paper-write /paper-compile, plus arxiv_search, web_search, wiki_note, figure_save, latex_compile, meeting_deck
  • Eleven bundled research skills (literature review, novelty check, experiment planning, citation audit, bilingual de-AI polish, rebuttal…) that teach the agent the workflow — no setup needed
Overview Paper Library Experiments
Overview Paper Library Experiments
Figures Meetings Servers Ledger
Figures Meetings Servers Ledger

Full MP4 demo (22 MB)

Quickstart

Prerequisites: Node.js ≥ 22, the dsh CLI (npm install -g @deepseek-ai/dsh), and a DEEPSEEK_API_KEY for agent sessions.

dsh plugin --profile web add dsh-mimir@latest   # installs and self-activates
dsh web                                          # then open http://127.0.0.1:3080

Got an old version (e.g. 0.11.x/0.12.x)? dsh's plugin store uses pnpm, which holds back freshly published releases by default. Pin the exact version instead: dsh plugin --profile web remove dsh-mimir && dsh plugin --profile web add dsh-mimir@0.14.1

Click Mimir in the sidebar footer. The wiki persists at ~/.dsh/storages/research_wiki.json; artifacts land under ./.research.

Optional capabilities:

  • Paper compilation — install a LaTeX engine (brew install tectonic is easiest), or set latex.engine to a binary path
  • Web search — the sxng CLI ships with the package; give it a SearXNG server with one command (Docker-free, local venv):
    bash scripts/setup-web-search.sh
  • Zotero — set zotero.apiKey / zotero.userId in the plugin config (keys at zotero.org/settings/keys)

Configuration

All keys are optional; set them in the profile's cordis.patch.yml (full commented example: examples/mimir-agent/cordis.yml).

Key Default Meaning
workspaceDir .research Research workspace root (artifacts, backups)
latex.engine auto latexmk / tectonic probe, or absolute binary path
search.command auto Web search: auto uses sxng from PATH or the bundled copy
reviewer.maxRounds 3 Per-project review-round budget
backup.enabled / intervalMinutes / keep true / 60 / 24 Scheduled wiki snapshots
skills.enabled true Register the eleven bundled research skills

Troubleshooting

  • Plugin not found — dsh resolves plugin names from the profile directory; install with dsh plugin --profile web add dsh-mimir@latest, not from your cwd.
  • LaTeX engine not foundbrew install tectonic, or point latex.engine at an absolute path. First tectonic compile downloads packages; raise latex.timeoutMs if it times out.
  • arXiv fails — export HTTPS_PROXY before starting dsh when behind a proxy.
  • Web search unavailable — run bash scripts/setup-web-search.sh (local SearXNG), or sxng init against your own instance, then restart dsh.

Changelog

  • 0.16.0 — Humanized ledger by @EriXPsy (#125): CBE cognitive map, brief view, idea-evolution worktree with ambient auto-capture, six-perspective digest capsules; research-paper-deai bilingual de-AI polish skill by @hkwuks (#126, synthesized from MIT-licensed aigc-humanizer-zh + blader/humanizer, LaTeX-safe with compile re-check)
  • 0.15.1 — cancelling web_search now terminates the sxng child process (no more zombie processes) by @hxhy (#124)
  • 0.15.0 — SearXNG web search by @hkwuks (#122): sxng-cli config panel (SxngConfig) in the Library web tab, agent search routed through the sxng skill; local LaTeX project import by @1692775560; tolerant project args + PDF fullscreen portal by @Nick (#120)
  • 0.14.0 — SearXNG web search by @hkwuks (#114): web_search tool + Library web-source tab; bundled sxng-cli + one-command SearXNG setup
  • 0.13.0 — figure-by-figure meeting decks from real paper PDFs, meeting_deck agent tool, academic-Group-meeting-skills pipeline integration
  • 0.12.0 — Meetings tab (group-meeting PPT), research-meeting-deck skill
  • 0.11.0 — single-package install: the workbench ships inside dsh-mimir itself
  • 0.10.0 — venue templates (CVPR/NeurIPS/ACL/IEEE/ACM…), custom kit upload, format-to-venue
  • 0.9.0 — per-project literature, AI relevance scoring, figure rename/caption + figure_organize, fullscreen PDF reader
  • 0.8.x — bundled research skills; collapsible subscriptions & project list
  • 0.7.0 — Zotero integration; Linear-style visual overhaul
  • Earlier — arXiv subscriptions, paper snapshots (diff/revert), metric→figure generation, related-work drafts, job writeback

Contributing

Branch off main (feature/<name> / fix/<name>), keep pnpm run build && pnpm test && pnpm run typecheck green, and open a PR — see CONTRIBUTING.md. Please merge PRs with a merge commit (not squash) so contributor authorship shows up on the contributors graph.

Contributors so far: @EriXPsy (Ledger view, humanized journal) · @hkwuks (SearXNG web search, sxng CLI, de-AI skill) · @hxhy (web_search cancellation fix)

Community

Questions, ideas, or show-and-tell — join the WeChat group (QR updated when it expires):

Mimir WeChat group

Acknowledgments

License

MIT

About

Mimir — 一站式科研工作台插件:LaTeX 论文边写边编译、arXiv 文献管理、实验追踪、指标图表、GPU 服务器 SSH 任务编排,管理科研全周期。An open-source research workbench plugin for the whole research cycle.

Topics

Resources

Contributing

Stars

132 stars

Watchers

5 watching

Forks

Releases

Packages

Contributors

Languages