Deepractice Agent - AI Agent Without CLI

Powerful AI Agent with Visual Interface - No Terminal Required

Tired of command-line tools? Deepractice Agent brings you full AI Agent capabilities through a beautiful web interface.

English | 简体中文

---

✨ Get Started in 3 Steps

Step 1: Run One Docker Command

docker run -d \
  --name agent \
  -p 5200:5200 \
  -e ANTHROPIC_API_KEY=sk-ant-xxxxx \
  -v $(pwd):/project \
  deepracticexs/agent:latest

Step 2: Open Your Browser

http://localhost:5200

Step 3: Start Chatting

That's it! No configuration files, no complex setup, just chat.

---

💡 Why Deepractice Agent?

❌ Traditional AI Agent Tools	✅ Deepractice Agent
Command-line only - steep learning curve	Visual interface - click and chat
Complex setup - hours of configuration	One command start - ready in 30 seconds
Terminal-bound - poor user experience	Session management - organize conversations
Hard to share or collaborate	Browser-based - access anywhere

---

🚀 Quick Start

Prerequisites

Before you start, make sure you have:

1. Docker installed - Install Docker
2. Anthropic API Key - Get API Key

Installation

Option 1: Docker Run (Recommended for Quick Try)

docker run -d \
  --name agent \
  -p 5200:5200 \
  -e ANTHROPIC_API_KEY=sk-ant-xxxxx \
  -v $(pwd):/project \
  deepracticexs/agent:latest

Access: Open http://localhost:5200 in your browser

Option 2: Docker Compose (Recommended for Production)

1. Create a .env file:

cp docker/agent/.env.example .env

2. Edit .env with your API key:

ANTHROPIC_API_KEY=sk-ant-xxxxx
ANTHROPIC_BASE_URL=https://api.anthropic.com
PROJECT_PATH=.

3. Start the service:

cd docker/agent
docker-compose up -d

4. View logs (optional):

docker-compose logs -f

5. Stop the service:

docker-compose down

Configuration

Required Environment Variables:

• ANTHROPIC_API_KEY - Your Anthropic API key

Optional Environment Variables:

• ANTHROPIC_BASE_URL - API endpoint (default: https://api.anthropic.com)
• PROJECT_PATH - Project directory to mount (default: current directory)

---

✨ Features

• 💬 Visual Chat Interface - No terminal, just type and chat
• 📂 Session Management - Organize and revisit your conversations
• 🔄 Real-time Streaming - See AI thinking and responding in real-time
• 🛠️ Tool Integration - AI can execute code, access files, and more
• 🔒 Self-hosted - Your data stays on your machine
• 🌍 Browser-based - Access from anywhere on your network
• 📦 One Container - Frontend + Backend + WebSocket all in one

---

❓ FAQ

Q: Do I need to know Docker? A: No. Just install Docker Desktop and copy-paste one command. That's all.

Q: Is my data secure? A: Yes. Everything runs locally on your machine. Your API key and conversations stay with you.

Q: Can I use other AI models besides Claude? A: Currently supports Anthropic Claude. Support for more models (OpenAI, local LLMs) is coming soon.

Q: What if I don't have an Anthropic API Key? A: You need to sign up at Anthropic Console and create an API key. It's free to start.

Q: Can I access Deepractice Agent from other devices? A: Yes. Replace localhost with your machine's IP address (e.g., http://192.168.1.100:5200).

Q: I got an error. Where can I get help? A: Check our Troubleshooting Guide or open an issue.

---

🔧 For Developers

Want to customize, contribute, or build from source?

• Docker Documentation - Build and deployment details
• Development Guide - How to contribute
• Architecture Overview - System design and technical details

Build from Source

# Install dependencies
pnpm install

# Start development servers
pnpm dev

# Build for production
pnpm build

---

🏢 About

Built with ❤️ by Deepractice

Part of Deepractice AI Ecosystem:

• PromptX - AI Agent Context Platform (Roles, Tools, Memory)
• Deepractice Agent - Visual AI Agent Interface (You are here)

Deepractice Agent provides the interface, PromptX provides the intelligence. Together, they make AI accessible to everyone.

---

⭐ Star History

---

Making AI Accessible to Everyone

If you find Deepractice Agent useful, please consider giving us a ⭐ on GitHub!