[PR #468] docs: add Astorm Agent integration guide (EN + zh-CN)

## 📋 Pull Request Information **Original PR:** https://github.com/deepseek-ai/awesome-deepseek-agent/pull/468 **Author:** [@hxuxingy1212](https://github.com/hxuxingy1212) **Created:** 10/21/2026 **Status:** 🔄 Open **Base:** `main` ← **Head:** `docs/add-astorm-agent` --- ### 📝 Commits (2) - [`844842a`](https://github.com/deepseek-ai/awesome-deepseek-agent/commit/844842a948908217eb4cf6384be07910f5f90e2f) docs: add Astorm Agent integration guide (EN + zh-CN) - [`34c48bc`](https://github.com/deepseek-ai/awesome-deepseek-agent/commit/34c48bc06c36b2ee3e880175eea61eb4e366c485) docs: use current DeepSeek Flash name and document Max effort ### 📊 Changes **4 files changed** (+168 additions, -0 deletions) <details> <summary>View changed files</summary> 📝 `README.md` (+1 -0) 📝 `README.zh-CN.md` (+1 -0) ➕ `docs/astorm_agent.md` (+83 -0) ➕ `docs/astorm_agent.zh-CN.md` (+83 -0) </details> ### 📄 Description ## Summary Adds a bilingual integration guide for **Astorm Agent**, an open-source local-first desktop AI agent built with Electron + Vue 3 + Rust. Astorm supports DeepSeek V4 through the OpenAI-compatible API. - `docs/astorm_agent.md` — English guide - `docs/astorm_agent.zh-CN.md` — Simplified Chinese guide - README table entries in both languages, inserted alphabetically before AstrBot - Astorm **0.1.1** adds a **Max** reasoning level; the guide documents it ## What the guide covers - Install on macOS (signed/notarized Apple Silicon release) or build from source - Configure the DeepSeek provider: Base URL `https://api.deepseek.com`, Chat Completions format, models `deepseek-v4-pro` / `deepseek-flash` - First chat: workspace selection, model + reasoning-effort chip, tool approvals - DeepSeek V4's 1M-token context window - Reasoning effort: None / Low / Medium / High / **Max** (Max requires Astorm 0.1.1+) - Troubleshooting for 401/404, the image-based Test button, and macOS Gatekeeper ## Notes for reviewers - **Model naming:** the guide uses `deepseek-flash`, which is the current Flash model name on DeepSeek's pricing page. The older `deepseek-v4-flash` name is still accepted as a legacy alias and is noted in the guide. - **Reasoning effort:** Astorm 0.1.1+ exposes five levels (None / Low / Medium / High / Max). **Max** maps to DeepSeek's `reasoning_effort: "max"`. The guide notes that older Astorm versions cap at High. - **Vision test:** Astorm's built-in **Test** button sends a text + image prompt. `deepseek-v4-pro` is text-only, so the guide explains that the test may report unsupported vision while text chat still works; `deepseek-flash` is vision-capable and can pass the test. - **Pricing:** no price table is embedded because prices change frequently; the guide links to the official DeepSeek pricing page. - No images were added. ## Checklist ### Agent Configuration - [x] Model names are current (`deepseek-v4-pro` / `deepseek-flash`; `deepseek-v4-flash` noted as a legacy alias) - [x] 1M context is configured or mentioned - [x] Max thinking effort level is supported — Astorm 0.1.1+ exposes Max (`reasoning_effort: "max"`) - [x] Pricing is current / no pricing table; official link included - [x] Config fields are verified to work in the agent - [x] No workarounds for already-fixed upstream bugs ### Documentation - [x] Both English and Chinese versions included in a single PR - [x] README table entry inserted in alphabetical order - [x] One tool per PR; unrelated tools not combined - [x] No images --- <sub>🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.</sub>

bsakaguchi commented

2026-10-26 09:49:53 +00:00

Owner

📋 Pull Request Information

Original PR: https://github.com/deepseek-ai/awesome-deepseek-agent/pull/468
Author: @hxuxingy1212
Created: 10/21/2026
Status: 🔄 Open

Base: main ← Head: docs/add-astorm-agent

📝 Commits (2)

844842a docs: add Astorm Agent integration guide (EN + zh-CN)
34c48bc docs: use current DeepSeek Flash name and document Max effort

📊 Changes

4 files changed (+168 additions, -0 deletions)

View changed files

📝 README.md (+1 -0)
📝 README.zh-CN.md (+1 -0)
➕ docs/astorm_agent.md (+83 -0)
➕ docs/astorm_agent.zh-CN.md (+83 -0)

📄 Description

Summary

Adds a bilingual integration guide for Astorm Agent, an open-source local-first desktop AI agent built with Electron + Vue 3 + Rust. Astorm supports DeepSeek V4 through the OpenAI-compatible API.

docs/astorm_agent.md — English guide
docs/astorm_agent.zh-CN.md — Simplified Chinese guide
README table entries in both languages, inserted alphabetically before AstrBot
Astorm 0.1.1 adds a Max reasoning level; the guide documents it

What the guide covers

Install on macOS (signed/notarized Apple Silicon release) or build from source
Configure the DeepSeek provider: Base URL https://api.deepseek.com, Chat Completions format, models deepseek-v4-pro / deepseek-flash
First chat: workspace selection, model + reasoning-effort chip, tool approvals
DeepSeek V4's 1M-token context window
Reasoning effort: None / Low / Medium / High / Max (Max requires Astorm 0.1.1+)
Troubleshooting for 401/404, the image-based Test button, and macOS Gatekeeper

Notes for reviewers

Model naming: the guide uses deepseek-flash, which is the current Flash model name on DeepSeek's pricing page. The older deepseek-v4-flash name is still accepted as a legacy alias and is noted in the guide.
Reasoning effort: Astorm 0.1.1+ exposes five levels (None / Low / Medium / High / Max). Max maps to DeepSeek's reasoning_effort: "max". The guide notes that older Astorm versions cap at High.
Vision test: Astorm's built-in Test button sends a text + image prompt. deepseek-v4-pro is text-only, so the guide explains that the test may report unsupported vision while text chat still works; deepseek-flash is vision-capable and can pass the test.
Pricing: no price table is embedded because prices change frequently; the guide links to the official DeepSeek pricing page.
No images were added.

Checklist

Agent Configuration

Model names are current (deepseek-v4-pro / deepseek-flash; deepseek-v4-flash noted as a legacy alias)
1M context is configured or mentioned
Max thinking effort level is supported — Astorm 0.1.1+ exposes Max (reasoning_effort: "max")
Pricing is current / no pricing table; official link included
Config fields are verified to work in the agent
No workarounds for already-fixed upstream bugs

Documentation

Both English and Chinese versions included in a single PR
README table entry inserted in alphabetical order
One tool per PR; unrelated tools not combined
No images

_{🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.}

bsakaguchi added the

pull-request

label

Rows
Columns

[PR #468] docs: add Astorm Agent integration guide (EN + zh-CN) #459