{"id":30392193,"url":"https://github.com/holasoymalva/deepseek-cli","last_synced_at":"2026-04-08T06:01:58.477Z","repository":{"id":301304782,"uuid":"1008576941","full_name":"holasoymalva/deepseek-cli","owner":"holasoymalva","description":"DeepSeek CLI, a command-line AI coding assistant that leverages the powerful DeepSeek Coder models ","archived":false,"fork":false,"pushed_at":"2025-08-25T02:40:29.000Z","size":71,"stargazers_count":86,"open_issues_count":17,"forks_count":15,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-10-29T09:34:05.514Z","etag":null,"topics":["artificial-intelligence","claude","claude-ai","claude-code","cursor","cursor-ai","deep-learning","deep-neural-networks","deepseek","deepseek-ai","deepseek-api","deepseek-chat","deepseek-coder","deepseek-llm","gemini-ai","gemini-api","gemini-cli","machine-learning","programming"],"latest_commit_sha":null,"homepage":"https://deepseek-cli.vercel.app/","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/holasoymalva.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-06-25T19:00:34.000Z","updated_at":"2025-10-29T05:31:17.000Z","dependencies_parsed_at":"2025-06-26T07:41:17.245Z","dependency_job_id":null,"html_url":"https://github.com/holasoymalva/deepseek-cli","commit_stats":null,"previous_names":["holasoymalva/deepseek-cli"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/holasoymalva/deepseek-cli","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/holasoymalva%2Fdeepseek-cli","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/holasoymalva%2Fdeepseek-cli/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/holasoymalva%2Fdeepseek-cli/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/holasoymalva%2Fdeepseek-cli/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/holasoymalva","download_url":"https://codeload.github.com/holasoymalva/deepseek-cli/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/holasoymalva%2Fdeepseek-cli/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31542384,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-07T16:28:08.000Z","status":"online","status_checked_at":"2026-04-08T02:00:06.127Z","response_time":54,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["artificial-intelligence","claude","claude-ai","claude-code","cursor","cursor-ai","deep-learning","deep-neural-networks","deepseek","deepseek-ai","deepseek-api","deepseek-chat","deepseek-coder","deepseek-llm","gemini-ai","gemini-api","gemini-cli","machine-learning","programming"],"created_at":"2025-08-21T11:01:12.403Z","updated_at":"2026-04-08T06:01:58.469Z","avatar_url":"https://github.com/holasoymalva.png","language":"TypeScript","readme":"# DeepSeek CLI\n[![MIT License](https://img.shields.io/badge/License-MIT-green.svg)](https://choosealicense.com/licenses/mit/)\n[![npm version](https://badge.fury.io/js/run-deepseek-cli.svg)](https://www.npmjs.com/package/run-deepseek-cli)\n[![TypeScript](https://badges.frapsoft.com/typescript/code/typescript.svg?v=101)](https://github.com/ellerbrock/typescript-badges/)\n\n![image](https://github.com/user-attachments/assets/5686866b-a841-4303-b7c4-c2c437816644)\n\n\nThis repository contains the DeepSeek CLI, a command-line AI coding assistant that leverages the powerful DeepSeek Coder models to accelerate your development workflows and enhance your coding experience.\n\nWith the DeepSeek CLI you can:\n\n- **Code Completion \u0026 Generation**: Get intelligent code suggestions and generate complete functions across 100+ programming languages.\n- **Repository-Level Understanding**: Analyze and work with large codebases using DeepSeek's advanced code comprehension capabilities.\n- **Code Refactoring \u0026 Migration**: Modernize legacy code, migrate between frameworks, and implement best practices.\n- **Debugging \u0026 Code Review**: Get help identifying bugs, security issues, and code quality improvements.\n- **Project Scaffolding**: Generate new applications, components, and boilerplate code from descriptions or requirements.\n- **Multi-Language Support**: Work seamlessly across Python, JavaScript, Java, C++, Go, Rust, and 90+ other languages.\n\n## Quickstart\n\n### 🏠 Local Setup (Recommended - Free \u0026 Private)\n\n1. **Prerequisites:** \n   - [Node.js version 18](https://nodejs.org/en/download) or higher\n   - [Ollama](https://ollama.ai) for local AI models\n\n2. **Install Ollama:**\n   ```bash\n   # macOS\n   brew install ollama\n   \n   # Linux\n   curl -fsSL https://ollama.ai/install.sh | sh\n   \n   # Windows: Download from https://ollama.ai\n   ```\n\n3. **Install the CLI:**\n   ```bash\n   npm install -g run-deepseek-cli\n   ```\n\n4. **Setup Local Environment:**\n   ```bash\n   # Start Ollama service\n   ollama serve\n   \n   # Install DeepSeek Coder model (choose one)\n   ollama pull deepseek-coder:6.7b    # Recommended (4GB)\n   ollama pull deepseek-coder:1.3b    # Lightweight (1GB)\n   ollama pull deepseek-coder:33b     # Most capable (19GB)\n   ```\n\n5. **Start Using:**\n   ```bash\n   deepseek\n   ```\n\n### ☁️ Cloud Setup (Requires API Key)\n\n1. **Install the CLI:**\n   ```bash\n   npm install -g run-deepseek-cli\n   ```\n\n2. **Configure API Access:**\n   ```bash\n   export DEEPSEEK_API_KEY=\"your_api_key_here\"\n   export DEEPSEEK_USE_LOCAL=false\n   ```\n   Get your API key from [DeepSeek Platform](https://platform.deepseek.com/api_keys).\n\n3. **Start Using:**\n   ```bash\n   deepseek\n   ```\n\n## Examples\n\nOnce the CLI is running, you can start interacting with DeepSeek Coder from your shell.\n\n### Start a New Project\n\n```sh\ncd new-project/\ndeepseek\n\u003e Create a FastAPI web application with user authentication and a PostgreSQL database\n```\n\n### Work with Existing Code\n\n```sh\ngit clone https://github.com/your-repo/existing-project\ncd existing-project\ndeepseek\n\u003e Analyze this codebase and suggest performance optimizations\n```\n\n### Code Completion and Generation\n\n```sh\ndeepseek\n\u003e Write a Python function to implement binary search with proper error handling\n```\n\n```sh\ndeepseek\n\u003e Convert this JavaScript function to TypeScript with proper type annotations\n```\n\n## Popular Tasks\n\n### Explore and Understand Code\n\nStart by `cd`ing into an existing or newly-cloned repository and running `deepseek`.\n\n```text\n\u003e Explain the architecture of this application and identify the main components.\n```\n\n```text\n\u003e What design patterns are used in this codebase?\n```\n\n```text\n\u003e Find potential security vulnerabilities in this code.\n```\n\n### Code Generation and Refactoring\n\n```text\n\u003e Implement a REST API for user management with CRUD operations.\n```\n\n```text\n\u003e Refactor this class to follow SOLID principles.\n```\n\n```text\n\u003e Add comprehensive error handling to this module.\n```\n\n### Migration and Modernization\n\n```text\n\u003e Help me migrate this React class component to hooks.\n```\n\n```text\n\u003e Convert this Python 2.7 code to Python 3.10 with type hints.\n```\n\n```text\n\u003e Upgrade this Express.js app to use async/await instead of callbacks.\n```\n\n### Code Review and Quality\n\n```text\n\u003e Review this pull request and suggest improvements.\n```\n\n```text\n\u003e Add unit tests for all functions in this file.\n```\n\n```text\n\u003e Optimize this algorithm for better time complexity.\n```\n\n### Project Setup\n\n```text\n\u003e Create a React TypeScript project with Redux Toolkit and Material-UI.\n```\n\n```text\n\u003e Set up a Django project with Docker, PostgreSQL, and Redis.\n```\n\n```text\n\u003e Generate a microservices architecture using Node.js and Docker Compose.\n```\n\n## Configuration\n\n### Environment Variables\n\n| Variable | Description | Default |\n|----------|-------------|---------|\n| `DEEPSEEK_USE_LOCAL` | Use local Ollama instead of cloud API | `true` |\n| `DEEPSEEK_MODEL` | Model to use | `deepseek-coder:6.7b` |\n| `OLLAMA_HOST` | Ollama server URL | `http://localhost:11434` |\n| `DEEPSEEK_API_KEY` | DeepSeek API key (cloud mode only) | - |\n\n### Local Models Available\n\n| Model | Size | Memory | Best For |\n|-------|------|--------|----------|\n| `deepseek-coder:1.3b` | 1GB | 2GB RAM | Quick completions, lightweight tasks |\n| `deepseek-coder:6.7b` | 4GB | 8GB RAM | General coding, recommended |\n| `deepseek-coder:33b` | 19GB | 32GB RAM | Complex analysis, best quality |\n\n### Configuration File\n\nCreate a `.env` file in your project root:\n\n```bash\n# Local mode (default)\nDEEPSEEK_USE_LOCAL=true\nDEEPSEEK_MODEL=deepseek-coder:6.7b\nOLLAMA_HOST=http://localhost:11434\n\n# Cloud mode (optional)\n# DEEPSEEK_USE_LOCAL=false\n# DEEPSEEK_API_KEY=your_api_key_here\n```\n\n## Supported Programming Languages\n\nDeepSeek CLI supports intelligent code generation and completion for 100+ programming languages including:\n\n**Popular Languages:**\n`Python`, `JavaScript`, `TypeScript`, `Java`, `C++`, `C#`, `Go`, `Rust`, `PHP`, `Ruby`, `Kotlin`, `Swift`, `Scala`, `R`, `Julia`, `Dart`, `HTML`, `CSS`, `SQL`\n\n**Systems \u0026 Scripting:**\n`Shell`, `PowerShell`, `Bash`, `Dockerfile`, `Makefile`, `YAML`, `JSON`, `XML`\n\n**Specialized:**\n`CUDA`, `Assembly`, `Verilog`, `VHDL`, `Solidity`, `Protocol Buffer`, `Thrift`\n\nFor the complete list, see [Supported Languages](./docs/supported-languages.md).\n\n## CLI Commands\n\n| Command | Description |\n|---------|-------------|\n| `deepseek` | Start interactive mode |\n| `deepseek setup` | Setup local Ollama environment |\n| `deepseek chat \"prompt\"` | Single prompt mode |\n| `deepseek --local` | Force local mode |\n| `deepseek --model \u003cmodel\u003e` | Specify model to use |\n| `deepseek --help` | Show help information |\n| `deepseek --version` | Show version |\n\n### Setup Command\n\nThe setup command helps you install and configure the local environment:\n\n```bash\ndeepseek setup\n```\n\nThis will:\n- Check if Ollama is installed\n- Start Ollama service if needed\n- Download the specified DeepSeek model\n- Verify everything is working\n\n### Interactive Mode\n\nThe interactive mode provides a rich REPL experience:\n\n- **Syntax Highlighting**: Color-coded responses for better readability\n- **Code Block Detection**: Automatic language detection and formatting\n- **Session History**: Navigate through previous commands\n- **File Context**: Automatic inclusion of relevant project files\n- **Multi-turn Conversations**: Maintain context across interactions\n\n## Advanced Features\n\n### Repository Context\n\nDeepSeek CLI automatically analyzes your repository structure and includes relevant context:\n\n```bash\n# Analyze entire repository\ndeepseek --include-all\n\u003e Suggest improvements for the overall code architecture\n\n# Include specific files/directories\ndeepseek --include src/ tests/ README.md\n\u003e Update the documentation to reflect recent API changes\n```\n\n### Code Templates\n\nGenerate common patterns and boilerplate:\n\n```text\n\u003e Generate a React component template with props validation\n\u003e Create a Python class with proper docstrings and type hints\n\u003e Set up a GitHub Actions workflow for CI/CD\n```\n\n### Integration Workflows\n\n```text\n\u003e Analyze the git diff and write a commit message\n\u003e Generate API documentation from this OpenAPI spec\n\u003e Create database migration scripts from these model changes\n```\n\n## Installation Options\n\n### NPM (Recommended)\n\n```bash\nnpm install -g run-deepseek-cli\n```\n\n### Development Installation\n\n```bash\ngit clone https://github.com/your-username/deepseek-cli.git\ncd deepseek-cli\nnpm install\nnpm run build\nnpm link\n```\n\n### Docker\n\n```bash\ndocker run -it -v $(pwd):/workspace -e DEEPSEEK_API_KEY=your_key deepseek/cli\n```\n\n## Contributing\n\nWe welcome contributions! Please see our [Contributing Guide](./CONTRIBUTING.md) for details.\n\n### Development Setup\n\n1. Fork and clone the repository\n2. Install dependencies: `npm install`\n3. Run tests: `npm test`\n4. Start development server: `npm run dev`\n\n### Building from Source\n\n```bash\nnpm run build\nnpm run package\n```\n\n## Documentation\n\n- [Full Documentation](./docs/index.md)\n- [API Reference](./docs/api.md)\n- [Configuration Guide](./docs/configuration.md)\n- [Troubleshooting](./docs/troubleshooting.md)\n- [Examples \u0026 Tutorials](./docs/examples.md)\n\n## Performance \u0026 Limits\n\n| Model | Speed | Context Window | Best For |\n|-------|-------|----------------|----------|\n| deepseek-coder-1.3b-instruct | Fastest | 16K tokens | Quick completions |\n| deepseek-coder-6.7b-instruct | Fast | 16K tokens | General coding tasks |\n| deepseek-coder-33b-instruct | Slower | 16K tokens | Complex analysis |\n\n## DeepSeek Models\n\nThis project leverages the DeepSeek Coder models:\n\n- **DeepSeek Coder Base**: Pre-trained on 2T tokens (87% code, 13% natural language)\n- **DeepSeek Coder Instruct**: Fine-tuned for instruction following and chat\n- **Multi-size Options**: 1.3B, 6.7B, and 33B parameter models available\n\nFor more details about the models, visit the [DeepSeek Coder GitHub repository](https://github.com/deepseek-ai/deepseek-coder).\n\n## Troubleshooting\n\n### Common Issues\n\n**API Key Issues:**\n```bash\nexport DEEPSEEK_API_KEY=\"your_actual_api_key\"\n# Verify with: echo $DEEPSEEK_API_KEY\n```\n\n**Node.js Version:**\n```bash\nnode --version  # Should be 18+\nnpm update -g deepseek-cli\n```\n\n**Permission Errors:**\n```bash\nsudo npm install -g run-deepseek-cli\n# Or use a Node version manager like nvm\n```\n\nFor more troubleshooting help, see our [Troubleshooting Guide](./docs/troubleshooting.md).\n\n## License\n\nThis project is licensed under the MIT License. See [LICENSE](./LICENSE) for details.\n\nThe use of DeepSeek Coder models is subject to the [DeepSeek Model License](https://github.com/deepseek-ai/deepseek-coder/blob/main/LICENSE-MODEL).\n\n## Citation\n\nIf you use this tool in your research or projects, please cite:\n\n```bibtex\n@misc{deepseek-cli,\n  title={DeepSeek CLI: Command-Line AI Coding Assistant},\n  author={Your Name},\n  year={2025},\n  url={https://github.com/your-username/deepseek-cli}\n}\n\n@misc{deepseek-coder,\n  author={Daya Guo, Qihao Zhu, Dejian Yang, Zhenda Xie, Kai Dong, Wentao Zhang, Guanting Chen, Xiao Bi, Y. Wu, Y.K. Li, Fuli Luo, Yingfei Xiong, Wenfeng Liang},\n  title={DeepSeek-Coder: When the Large Language Model Meets Programming -- The Rise of Code Intelligence},\n  journal={CoRR},\n  volume={abs/2401.14196},\n  year={2024},\n  url={https://arxiv.org/abs/2401.14196}\n}\n```\n\n## Contact \u0026 Support\n\n- **Issues**: [GitHub Issues](https://github.com/holasoymalva/deepseek-cli/issues)\n- **Discussions**: [GitHub Discussions](https://github.com/holasoymalva/deepseek-cli/discussions)\n- **DeepSeek Support**: service@deepseek.com\n\n## Acknowledgments\n\n- Built on the foundation of [Gemini CLI](https://github.com/google-gemini/gemini-cli)\n- Powered by [DeepSeek Coder](https://github.com/deepseek-ai/deepseek-coder) models\n- Thanks to the open-source community for contributions and feedback\n","funding_links":[],"categories":["Forks","TypeScript","ツール"],"sub_categories":["IDE \u0026 エディタアシスタント"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fholasoymalva%2Fdeepseek-cli","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fholasoymalva%2Fdeepseek-cli","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fholasoymalva%2Fdeepseek-cli/lists"}