prateekrajgautam/deepseek-harness repository overview

⁠DSH (DeepSeek Harness) - Docker Image

A containerized web interface for DeepSeek AI models

Run a full-featured DeepSeek AI chat interface with one command.

⁠Quick Start

1. Create a .env file

   DEEPSEEK_API_KEY=sk-your-api-key-here
   DSH_TOKEN=your-custom-fixed-token-here
   IMAGE_TAG=1.0.14
   

   Copy

2. Run with Docker Compose

    services:
      dsh:
        image: "prateekrajgautam/dsh:${IMAGE_TAG:-latest}"
   
        container_name: dsh
   
        # Required because DSH only supports localhost binding.
        # With host networking, container localhost maps to host localhost.
        network_mode: host
   
        env_file:
          - .env
   
        restart: unless-stopped
   
        environment:
          # DeepSeek API key
          DEEPSEEK_API_KEY: ${DEEPSEEK_API_KEY}
   
          # Authentication token for DSH
          DSH_TOKEN: ${DSH_TOKEN}
   
        volumes:
          # Persistent DSH configuration and session data
          - dsh_data:/root/.dsh
   
          # Optional custom plugins
          - dsh_plugins:/app/plugins
   
    volumes:
      dsh_data:
        name: dsh_data
   
      dsh_plugins:
        name: dsh_plugins
   

   Copy

3. Start the service

   docker compose up -d
   docker compose logs
   

   Copy

Then open http://127.0.0.1:3080/?token=your-custom-fixed-token-here⁠ in your browser.

⁠Configuration

⁠Environment Variables (.env)

⁠Volumes

⁠Features

Modern Web UI

• Clean, responsive interface
• Real-time chat
• Conversation history

Extensible Plugin System

• Build custom integrations
• Extend functionality
• Add data sources

Persistent Storage

• All data saved locally in volumes
• Easy backup and migration
• No data loss on container restart

Multi-Model Support

• Access all DeepSeek models
• Model switching in UI
• Fine-tuned parameter control

⁠Usage

⁠Basic Commands

# Start the service
docker compose up -d

# View logs
docker compose logs -f dsh

# Stop the service
docker compose down

# Restart the service (to apply .env changes)
docker compose up -d

⁠Troubleshooting

⁠Web UI Not Loading

1. Verify container is running: docker compose ps
2. Test connectivity: curl -v http://127.0.0.1:3080
3. Review logs: docker compose logs dsh

⁠API Key or Token Not Working

1. Ensure the .env file is created and correctly formatted.
2. Restart the container to apply changes: docker compose up -d.
3. Check container environment variables: docker inspect dsh | grep -A 10 "Env"

⁠Architecture

┌─────────────────────────────────┐
│     Web Browser (3080)          │
└────────────────┬────────────────┘
                 │
┌────────────────▼────────────────┐
│   Docker Container (dsh)        │
├─────────────────────────────────┤
│  Node.js + DeepSeek Harness     │
├─────────────────────────────────┤
│  ✓ Web UI (Pnpm)                │
│  ✓ API Client                   │
├─────────────────────────────────┤
│  Volumes:                       │
│  • dsh_data (Settings/History)  │
│  • dsh_plugins (Plugins)        │
└──────────┬──────────────────────┘
           │
┌──────────▼──────────────────────┐
│   DeepSeek API                  │
│  (api.deepseek.com)             │
└─────────────────────────────────┘

⁠Support

• Repository: github.com/prateekrajgautam/dsh⁠
• Issues: GitHub Issues⁠

⁠License

MIT License