Skip to content

rickscode/Deep-Code

Repository files navigation

Deep-Code: Open Source CLI Coding Agent

Screenshot from 2025-06-08 23-35-07

What is this?

A free, open-source alternative to proprietary AI coding assistants (like Claude Code). Deep Code is a CLI tool that lets you:

  • Build, edit, and analyze code and apps using DeepSeek via Groq API
  • Automatically generate and save code files/folders for your requests—no more copy-paste!
  • Use a privacy-first, community-driven, extensible coding agent.

Why?

  • Proprietary tools are expensive and closed-source ($17–$200/month)
  • You deserve full control, privacy, and transparency
  • Open-source means no vendor lock-in and community-driven improvements

Progress So Far

  • Project structure, MIT license, and CI/CD
  • Python virtual environment support
  • CLI with config, chat, and version commands
  • Interactive config: set API key and DeepSeek model
  • Multi-turn coding chat: ask for an app, code is saved to files/folders automatically
  • Clean output: only assistant replies, not raw API responses
  • Error handling and user feedback

Improvements Still To Be Made

  • Smarter folder and file naming (e.g., use app name, language, or user intent)
  • Fewer commands: after config, launch coding chat automatically (no extra command needed)
  • One-step startup: auto-create/activate venv and install dependencies if missing
  • Global CLI install (e.g., just type ai-code anywhere)
  • More robust multi-file project support
  • Plugin system for extensibility
  • Git integration, code analysis, and more

Supported Models

  • deepseek-r1-distill-llama-70b

Quick Start

1. Clone and Install:

git clone <repo-url>
cd ai-code
python3 -m venv .venv
source .venv/bin/activate
pip install -e .

2. Configure API Key:

deep-code config --set
# (Enter your Groq API key for DeepSeek)

3. Start Coding:

deep-code

That's it! Just type deep-code anywhere and start building apps. The AI will:

  • Generate code automatically
  • Save files to folders
  • Validate and fix errors
  • Create working applications

Examples:

  • "build me a todo list web app"
  • "create a calculator with buttons"
  • "make a responsive landing page"

Type /exit to quit.

Roadmap

  • Smarter file/folder naming
  • Fewer startup steps
  • Global CLI install
  • Plugins, git, and more

License

MIT

About

An open source alternative to Claude Code CLI Agent

Resources

License

Code of conduct

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published