Pine
3dacd6e399
- README.md / README.zh.md: add a bilingual "community fork" banner noting this is a derivative of deepseek-ai/deepseek-harness with a desktop app, plugin marketplace, image recognition, and a release channel; link to the modification notes. - MODIFICATIONS.md / MODIFICATIONS.zh.md: standard, bilingual list of changes vs upstream. - LICENSE: keep MIT, add PineSound as derivative copyright holder while preserving the original DeepSeek copyright, and point to MODIFICATIONS.md. Co-Authored-By: Claude <noreply@anthropic.com>
66 lines
2.2 KiB
Markdown
66 lines
2.2 KiB
Markdown
# DeepSeek Harness
|
|
|
|
English | [中文](README.zh.md)
|
|
|
|
> **Community fork notice**: This repository is a community derivative of
|
|
> [deepseek-ai/deepseek-harness](https://github.com/deepseek-ai/deepseek-harness),
|
|
> maintained by PineSound. On top of the **unchanged core harness** it adds a
|
|
> **desktop app** ([deepseek-harness-desktop](https://github.com/PineKings/deepseek-harness-desktop)),
|
|
> a plugin marketplace, image recognition, and a release channel. This is **not
|
|
> the official DeepSeek repository**. See [MODIFICATIONS.md](MODIFICATIONS.md)
|
|
> for the full list of changes; licensed under [MIT](LICENSE).
|
|
|
|
DeepSeek Harness (`dsh`) is an open-source agent harness developed by [DeepSeek AI](https://deepseek.com).
|
|
|
|
It uses an architecture where **everything is a plugin**, and is powered by [Cordis](https://github.com/cordiverse/cordis), whose design is described in [_A Programming Paradigm for Spatiotemporal Composability_](https://github.com/cordiverse/paper).
|
|
|
|
## Developer preview
|
|
|
|
DeepSeek Harness is currently in _developer preview_ and is iterating rapidly. **THERE WILL BE COMPATIBILITY-BREAKING CHANGES.**
|
|
|
|
## Run
|
|
|
|
### Run from `npm`
|
|
|
|
Install `Node.js`, then run:
|
|
|
|
```sh
|
|
npx @deepseek-ai/dsh web
|
|
```
|
|
|
|
The command starts the Web UI, served at `http://127.0.0.1:3080` by default. See [Web UI guide](docs/user/guide/index.md).
|
|
|
|
### Run from source
|
|
|
|
To run from a repository checkout:
|
|
|
|
```sh
|
|
git clone https://github.com/deepseek-ai/deepseek-harness.git
|
|
cd deepseek-harness
|
|
pnpm install
|
|
pnpm run build
|
|
pnpm dsh web
|
|
```
|
|
|
|
## Community and support
|
|
|
|
- Feel free to submit feedback or bug reports through [GitHub Discussions](https://github.com/deepseek-ai/deepseek-harness/discussions).
|
|
- Add the [`dsh-plugin`](https://github.com/topics/dsh-plugin) topic to your plugin repository for discoverability.
|
|
- Join <a href="https://discord.gg/Ycq5dCaS4">DeepSeek Harness Discord community</a>.
|
|
|
|
## Contributing
|
|
|
|
See [CONTRIBUTING.md](CONTRIBUTING.md).
|
|
|
|
## Development
|
|
|
|
Start with the [development guide](docs/development.md) and [architecture documentation](docs/architecture.md).
|
|
|
|
For agents, follow [AGENTS.md](AGENTS.md).
|
|
|
|
## License
|
|
|
|
[MIT](LICENSE)
|
|
|
|
Third-party dependencies and their licenses are disclosed in [THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md).
|