Alego

English | 中文

Alego (alego) is an open-source agent harness from Singula AI: a building-block foundation for AI agent applications.

It is built on an everything-is-a-plugin architecture and powered by Cordis, whose design is described in A Programming Paradigm for Spatiotemporal Composability.

Alego is an independent fork of DeepSeek Harness, with no affiliation or endorsement from DeepSeek. Start with the documentation.

Developer preview

Alego is in developer preview and iterating rapidly. THERE WILL BE COMPATIBILITY-BREAKING CHANGES.

Review the safety notice before running the project.

Run

Run from npm

Install Node.js, then run:

npx @singula-ai/alego web

The command starts the Web UI at http://127.0.0.1:3080 by default and opens it in the default browser for a local launch. An SSH launch only prints the host URL because the SSH client or editor owns the local forwarded address. Pass --no-open to run the server without opening a browser. See Web UI guide.

Run from source

On Linux/macOS, the source installer builds Alego and adds a launcher in ~/.local/bin:

curl -fsSL https://raw.githubusercontent.com/singula-ai/alego/main/install.sh | bash

To run from a repository checkout:

git clone https://github.com/singula-ai/alego.git
cd alego
pnpm install
pnpm run build
pnpm alego web

pnpm run build prepares the repository artifacts. pnpm alego web uses those built artifacts without rebuilding.

Community and support

• Submit feedback or bug reports through GitHub Discussions.
• Add the alego-plugin topic to your plugin repository for discoverability.
• Project site: https://alego.dev.

Contributing

See CONTRIBUTING.md.

Development

Start with the development guide and architecture documentation.

For agents, follow AGENTS.md.

Citation

@misc{deepseek-harness2026,
  title={DeepSeek Harness: Everything is a Plugin},
  author={DeepSeek-AI},
  year={2026},
  publisher={GitHub},
  howpublished={\url{https://github.com/deepseek-ai/deepseek-harness}},
}

License

MIT

Third-party dependencies and their licenses are disclosed in THIRD_PARTY_NOTICES.md.