Настройка DeepCode: Open Agentic Coding

DeepCode — мультиагентная система для автоматизации генерации кода. Основные функции включают Paper2Code (реализация алгоритмов из научных статей), Text2Web и Text2Backend.

1. Требования (Prerequisites)

• Python 3.9+
• Node.js 18+
• npm 8+

Проверка версий в терминале:

python --version
node --version
npm --version

2. Установка

Вариант А: Установка через pip

pip install deepcode-hku
# Загрузка конфигурационных файлов
curl -O https://raw.githubusercontent.com/HKUDS/DeepCode/main/mcp_agent.config.yaml
curl -O https://raw.githubusercontent.com/HKUDS/DeepCode/main/mcp_agent.secrets.yaml

Вариант Б: Установка из исходного кода

git clone https://github.com/HKUDS/DeepCode.git
cd DeepCode/
pip install -r requirements.txt
npm install --prefix new_ui/frontend

3. Конфигурация

DeepCode использует протокол MCP (Model Context Protocol). Настройка API-ключей выполняется в файле mcp_agent.secrets.yaml.

Поддерживаемые провайдеры:

• OpenAI (включая OpenRouter).
• Anthropic (модели Claude).
• Google (модели Gemini).
• Ollama (локальные модели через OpenAI-совместимый API).

Пример настройки в mcp_agent.secrets.yaml:

openai:
  api_key: "your_api_key"
  base_url: "http://localhost:11434/v1" # Для Ollama
google:
  api_key: "your_api_key"

Выбор активного провайдера осуществляется в mcp_agent.config.yaml в поле llm_provider.

4. Запуск

Локальный запуск

Для запуска CLI и Web-интерфейса используйте команду:

deepcode

• Backend будет доступен на порту 8000.
• Frontend будет доступен на порту 5173.

Запуск в Docker

./deepcode_docker/run_docker.sh

Интерфейс будет доступен по адресу http://localhost:8000.

5. Решение проблем (Troubleshooting)

• Ошибка tsc: not found при сборке Docker: Очистите кэш сборщика: docker builder prune -f.
• Проблемы с фронтендом: Переустановите зависимости Node.js: cd new_ui/frontend && rm -rf node_modules && npm install.
• Windows: В файле конфигурации mcp_agent.config.yaml для MCP-серверов необходимо указывать абсолютные пути.

@tsingular