https://github.com/getasterisk/deepclaude
A high-performance LLM inference API and Chat UI that integrates DeepSeek R1's CoT reasoning traces with Anthropic Claude models.
https://github.com/getasterisk/deepclaude
ai anthropic anthropic-claude api chain-of-thought claude deepseek deepseek-r1 llm rust
Last synced: 3 days ago
JSON representation
A high-performance LLM inference API and Chat UI that integrates DeepSeek R1's CoT reasoning traces with Anthropic Claude models.
- Host: GitHub
- URL: https://github.com/getasterisk/deepclaude
- Owner: getAsterisk
- License: mit
- Created: 2025-01-26T16:25:41.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2025-02-04T22:55:51.000Z (3 months ago)
- Last Synced: 2025-04-29T13:57:54.179Z (17 days ago)
- Topics: ai, anthropic, anthropic-claude, api, chain-of-thought, claude, deepseek, deepseek-r1, llm, rust
- Language: Rust
- Homepage: https://deepclaude.com
- Size: 669 KB
- Stars: 5,084
- Watchers: 43
- Forks: 399
- Open Issues: 48
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE.md
Awesome Lists containing this project
README
DeepClaude 🐬🧠
Harness the power of DeepSeek R1's reasoning and Claude's creativity and code generation capabilities with a unified API and chat interface.
[](https://github.com/getasterisk/deepclaude/blob/main/LICENSE.md)
[](https://www.rust-lang.org/)
[](https://deepclaude.asterisk.so)
[Getting Started](#getting-started) •
[Features](#features) •
[API Usage](#api-usage) •
[Documentation](#documentation) •
[Self-Hosting](#self-hosting) •
[Contributing](#contributing)
## Table of Contents
- [Overview](#overview)
- [Features](#features)
- [Why R1 + Claude?](#why-r1--claude)
- [Getting Started](#getting-started)
- [Prerequisites](#prerequisites)
- [Installation](#installation)
- [Configuration](#configuration)
- [API Usage](#api-usage)
- [Basic Example](#basic-example)
- [Streaming Example](#streaming-example)
- [Configuration Options](#configuration-options)
- [Self-Hosting](#self-hosting)
- [Security](#security)
- [Contributing](#contributing)
- [License](#license)
- [Acknowledgments](#acknowledgments)
## Overview
DeepClaude is a high-performance LLM inference API that combines DeepSeek R1's Chain of Thought (CoT) reasoning capabilities with Anthropic Claude's creative and code generation prowess. It provides a unified interface for leveraging the strengths of both models while maintaining complete control over your API keys and data.
## Features
🚀 **Zero Latency** - Instant responses with R1's CoT followed by Claude's response in a single stream, powered by a high-performance Rust API
🔒 **Private & Secure** - End-to-end security with local API key management. Your data stays private
⚙️ **Highly Configurable** - Customize every aspect of the API and interface to match your needs
🌟 **Open Source** - Free and open-source codebase. Contribute, modify, and deploy as you wish
🤖 **Dual AI Power** - Combine DeepSeek R1's reasoning with Claude's creativity and code generation
🔑 **Managed BYOK API** - Use your own API keys with our managed infrastructure for complete control
## Why R1 + Claude?
DeepSeek R1's CoT trace demonstrates deep reasoning to the point of an LLM experiencing "metacognition" - correcting itself, thinking about edge cases, and performing quasi Monte Carlo Tree Search in natural language.
However, R1 lacks in code generation, creativity, and conversational skills. Claude 3.5 Sonnet excels in these areas, making it the perfect complement. DeepClaude combines both models to provide:
- R1's exceptional reasoning and problem-solving capabilities
- Claude's superior code generation and creativity
- Fast streaming responses in a single API call
- Complete control with your own API keys
## Getting Started
### Prerequisites
- Rust 1.75 or higher
- DeepSeek API key
- Anthropic API key
### Installation
1. Clone the repository:
```bash
git clone https://github.com/getasterisk/deepclaude.git
cd deepclaude
```
2. Build the project:
```bash
cargo build --release
```
### Configuration
Create a `config.toml` file in the project root:
```toml
[server]
host = "127.0.0.1"
port = 3000
[pricing]
# Configure pricing settings for usage tracking
```
## API Usage
See [API Docs](https://deepclaude.chat)
### Basic Example
```python
import requests
response = requests.post(
"http://127.0.0.1:1337/",
headers={
"X-DeepSeek-API-Token": "",
"X-Anthropic-API-Token": ""
},
json={
"messages": [
{"role": "user", "content": "How many 'r's in the word 'strawberry'?"}
]
}
)
print(response.json())
```
### Streaming Example
```python
import asyncio
import json
import httpx
async def stream_response():
async with httpx.AsyncClient() as client:
async with client.stream(
"POST",
"http://127.0.0.1:1337/",
headers={
"X-DeepSeek-API-Token": "",
"X-Anthropic-API-Token": ""
},
json={
"stream": True,
"messages": [
{"role": "user", "content": "How many 'r's in the word 'strawberry'?"}
]
}
) as response:
response.raise_for_status()
async for line in response.aiter_lines():
if line:
if line.startswith('data: '):
data = line[6:]
try:
parsed_data = json.loads(data)
if 'content' in parsed_data:
content = parsed_data.get('content', '')[0]['text']
print(content, end='',flush=True)
else:
print(data, flush=True)
except json.JSONDecodeError:
pass
if __name__ == "__main__":
asyncio.run(stream_response())
```
## Configuration Options
The API supports extensive configuration through the request body:
```json
{
"stream": false,
"verbose": false,
"system": "Optional system prompt",
"messages": [...],
"deepseek_config": {
"headers": {},
"body": {}
},
"anthropic_config": {
"headers": {},
"body": {}
}
}
```
## Self-Hosting
DeepClaude can be self-hosted on your own infrastructure. Follow these steps:
1. Configure environment variables or `config.toml`
2. Build the Docker image or compile from source
3. Deploy to your preferred hosting platform
## Security
- No data storage or logged
- BYOK (Bring Your Own Keys) architecture
- Regular security audits and updates
## Contributing
We welcome contributions! Please see our [Contributing Guidelines](CONTRIBUTING.md) for details on:
- Code of Conduct
- Development process
- Submitting pull requests
- Reporting issues
## License
This project is licensed under the MIT License - see the [LICENSE](LICENSE.md) file for details.
## Acknowledgments
DeepClaude is a free and open-source project by [Asterisk](https://asterisk.so/). Special thanks to:
- DeepSeek for their incredible R1 model
- Anthropic for Claude's capabilities
- The open-source community for their continuous support
---