8b-is / deepsiper-enthea

Deepsiper Enthea

English | 中文

Deepsiper Enthea (deepsiper-enthea) is a sovereign, agent-driven LLM evaluation harness forked from deepseek-ai/deepseek-harness (dsh 0.1.0-rc.7). It provides end-to-end multi-model orchestration, self-hosted and sovereign backend integration, Cordis-powered extensible plugin pipelines, and JSON-RPC automation for modern LLM evaluation workflows.

---

Fork Enhancements

• Sovereign Backend: Native integration with EntheAI and self-hosted inference nodes with zero external data leakage.
• Evaluation Plugins: Pluggable evaluation suites including tool-eval, eval-entheai, and custom benchmarking metrics.
• OpenCode Bridge & JSON-RPC SDK: Drive evaluation runs and automated agent loops programmatically from OpenCode or custom orchestrators.
• Multi-Model Orchestration: Unified provider interfaces for DeepSeek, Gemini, local models, and any OpenAI-compatible endpoint.
• Granular Sandboxing & Telemetry: Native Landlock isolation, deterministic replay, and structured session persistence.

---

Architecture & Stack

Everything in Deepsiper Enthea is a composable Cordis plugin.

                  ┌─────────────────────────────────────┐
                  │    OpenCode / JSON-RPC / CLI / Web   │
                  └──────────────────┬──────────────────┘
                                     │
                  ┌──────────────────▼──────────────────┐
                  │      Cordis Kernel (Context & DI)   │
                  └────┬──────────────┬───────────────┬─┘
                       │              │               │
        ┌──────────────▼─────┐ ┌──────▼──────┐ ┌──────▼──────────────┐
        │  Sovereign Backends│ │ Eval Plugins│ │ Sandboxed Tool Seams│
        │  (EntheAI / Local) │ │ (tool-eval) │ │ (Landlock / Bash)   │
        └────────────────────┘ └─────────────┘ └─────────────────────┘

• Runtime & Language: Node.js >=22.19.0 or >=24.0.0, TypeScript 6 (Strict ESM)
• Bundler & Build: tsdown / rolldown + tsc project references
• Testing & Quality: Vitest 4, Oxlint, JSCPD clone detection
• Plugin Kernel: Vendored Cordis framework with spatiotemporal composability

---

Quick Start

Prerequisites

• Node.js ^22.19.0 || >=24.0.0
• pnpm >= 11.0.0

Installation & Build

# Clone repository
git clone https://github.com/8b-is/deepsiper-enthea.git
cd deepsiper-enthea

# Install dependencies and build harness
pnpm install
pnpm build

Run Tasks

# Run a headless task using the sovereign profile
pnpm dsh --profile headless "Analyze repository security posture and evaluate tool coverage"

# Start the interactive Web UI and dashboard
pnpm dsh web

---

Documentation

• Getting Started Guide
• Architecture & Plugin Seams
• Writing Custom Plugins
• JSON-RPC SDK
• Sovereign Backends (EntheAI)
• Design System Spec

---

Community & Ecosystem

• Fork Origin: 8b-is/deepsiper-enthea
• Upstream: deepseek-ai/deepseek-harness
• Organization: 8b-is

---

License

MIT © 8b-is & DeepSeek AI contributors. Third-party dependency notices are listed in THIRD_PARTY_NOTICES.md.