{"id":25452789,"url":"https://github.com/yllvar/deepseek-engineer","last_synced_at":"2025-05-16T13:10:31.992Z","repository":{"id":274149029,"uuid":"922062837","full_name":"yllvar/DeepSeek-Engineer","owner":"yllvar","description":"Save time and boost productivity with DeepSeek Engineer, a powerful coding assistant powered by DeepSeek's R1 capabilities. This project is designed to help you write code faster, debug smarter, and streamline your development workflow.","archived":false,"fork":false,"pushed_at":"2025-01-25T09:45:24.000Z","size":127,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-02-17T23:41:56.872Z","etag":null,"topics":["agentic-ai","ai","deepseek-r1"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/yllvar.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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}},"created_at":"2025-01-25T08:01:36.000Z","updated_at":"2025-02-01T18:27:10.000Z","dependencies_parsed_at":null,"dependency_job_id":"5a3eb77a-f119-407b-a163-501a4e4c6cb1","html_url":"https://github.com/yllvar/DeepSeek-Engineer","commit_stats":null,"previous_names":["yllvar/deepseek-engineer"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yllvar%2FDeepSeek-Engineer","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yllvar%2FDeepSeek-Engineer/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yllvar%2FDeepSeek-Engineer/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yllvar%2FDeepSeek-Engineer/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/yllvar","download_url":"https://codeload.github.com/yllvar/DeepSeek-Engineer/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254535822,"owners_count":22087399,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["agentic-ai","ai","deepseek-r1"],"created_at":"2025-02-17T23:41:36.681Z","updated_at":"2025-05-16T13:10:31.971Z","avatar_url":"https://github.com/yllvar.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\n\u003cimg width=\"844\" alt=\"Screenshot 2025-01-25 at 17 11 12\" src=\"https://github.com/user-attachments/assets/1cfd12eb-c91e-4429-b1bf-cbb5a29144db\" /\u003e\n\n# 🚀 DeepSeek Engineer: Code Faster, Smarter, and More Efficiently! 🚀\n\n**DeepSeek Engineer** is your ultimate tool for writing code faster, taking on more projects, and looking like a coding wizard! 🧙‍♂️ Whether you're a seasoned developer or just starting out, this project is designed to supercharge your workflow and make coding a breeze. Let's dive in! 🌊\n\n---\n\n## 🛠️ Getting Started\n\n### 1. **Install Dependencies**\n\nFirst things first, let's get everything set up. Run the following command to install all the necessary dependencies:\n\n```shellscript\nnpm install\n```\n\n### 2. **Set Up Environment Variables**\n\nNext, create a `.env.local` file in the root directory and add your DeepSeek API key:\n\n```plaintext\nDEEPSEEK_API_KEY=your_api_key_here\n```\n\n### 3. **Start the Development Server**\n\nNow, let's fire up the development server:\n\n```shellscript\nnpm run dev\n```\n\nOnce the server is running, you can access the application at `http://localhost:3000`.\n\n---\n\n## 🏗️ Code Architecture\n\nThe project is built with a modular architecture, ensuring a clear separation of concerns. Here's a breakdown of the core components:\n\n### **Core Components**\n\n- **`src/components/Chat.tsx`**: The main chat interface component.\n- **`src/hooks/useChat.ts`**: Custom hook for managing chat functionality.\n- **`src/utils/deepseek-client.ts`**: Handles integration with the DeepSeek API.\n- **`src/utils/file-operations.ts`**: Manages file system operations.\n- **`src/utils/conversation-manager.ts`**: Handles chat history and context management.\n\n---\n\n## ✨ Key Features\n\n### **1. Chat Interface**\n\n- **Real-time message streaming** 💬\n- **Markdown support** 📝\n- **Code syntax highlighting** 🌈\n- **Error handling and loading states** ⚠️\n\n### **2. File Operations**\n\n- **File reading and writing** 📂\n- **Directory traversal** 🗂️\n- **Diff generation for file modifications** 🔄\n- **Safety checks and validations** ✅\n\n### **3. AI Integration**\n\n- **Context-aware responses** 🤖\n- **Code analysis capabilities** 🔍\n- **Intelligent code modifications** 🛠️\n- **Rate limiting and error handling** ⏳\n\n---\n\n## 🎮 Usage\n\n### **Basic Chat**\n\nSimply type your questions or requests in the chat interface. The AI will respond with relevant code, explanations, or suggestions.\n\n### **File Operations**\n\nUse the following commands in the chat:\n\n- **`/add \u003cpath\u003e`**: Add a file or directory to the conversation context.\n- **`/ls \u003cpath\u003e`**: List contents of a directory.\n- **`/cat \u003cpath\u003e`**: Display contents of a file.\n- **`/exec \u003ccommand\u003e`**: Execute a shell command (use with caution).\n\n### **Code Modifications**\n\nWhen requesting code changes, the AI will:\n\n1. Analyze the existing code.\n2. Generate appropriate modifications.\n3. Show a diff preview of changes.\n4. Apply the changes upon confirmation.\n\n---\n\n## 🚀 Development\n\n### **Building for Production**\n\n```shellscript\nnpm run build\nnpm start\n```\n\n### **Running Tests**\n\n```shellscript\nnpm run test\n```\n\n### **Linting**\n\n```shellscript\nnpm run lint\n```\n\n---\n\n## 🔮 Future Improvements\n\n### **1. Enhanced IDE Integration**\n\n- **VSCode extension** 🖥️\n- **Direct file editing capabilities** ✏️\n- **Syntax-aware code modifications** 🧠\n\n### **2. Advanced Features**\n\n- **Multi-file context understanding** 📚\n- **Project-wide refactoring** 🔧\n- **Test generation** 🧪\n- **Documentation generation** 📄\n\n### **3. User Experience**\n\n- **Custom themes** 🎨\n- **Keyboard shortcuts** ⌨️\n- **Command history** ⏪\n- **Context persistence** 💾\n\n### **4. Security**\n\n- **Role-based access control** 🔐\n- **Secure file operations** 🛡️\n- **API key rotation** 🔄\n\n### **5. Performance**\n\n- **Response caching** ⚡\n- **Optimized file operations** 🚀\n- **Reduced API calls** 📉\n\n---\n\n## 🤝 Contributing\n\nWe welcome contributions from the community! Whether you're fixing a bug, adding a feature, or just want to brainstorm ideas, we'd love to have you on board. Please feel free to submit a Pull Request or reach out to us. We believe there are smarter people out there, and we're eager to learn from you! 🌟\n\n---\n\n## 📜 License\n\nThis project is licensed under the MIT License. For more details, see the [LICENSE](LICENSE) file.\n\n---\n\n## 🙏 Acknowledgments\n\n- **Built with [Next.js](https://nextjs.org/)** ⚛️\n- **Powered by [DeepSeek API](https://deepseek.com)** 🤖\n- **UI components from [shadcn/ui](https://ui.shadcn.com/)** 🎨\n\n---\n\n## 🆘 Support\n\nFor support, please open an issue in the GitHub repository or contact the maintainers.\n\n---\n\n## 🚨 Important Note on File Access\n\n### **Local Development vs. Deployed Environment**\n\n1. **Local Development**:\n   - When running the application locally on your machine, it can access local files.\n   - Commands like `/add`, `/ls`, and `/cat` will work as expected, allowing you to interact with files on your local machine.\n\n2. **Deployed on Vercel**:\n   - The deployed application **cannot** access files on your local machine.\n   - File operations will not work in the deployed environment as it lacks access to your local file system.\n\n### **Intended Use**\n\n- **Local Development**: The file access features are primarily for development and testing on your local machine.\n- **Deployed Environment**: When deployed, the application should be adapted to work with cloud storage solutions or other methods of file handling that don't rely on local file access.\n\n### **Adapting for Deployment**\n\nTo make the application work similarly when deployed, consider the following steps:\n\n1. **Implement a file upload feature** to send local files to the server.\n2. **Use cloud storage** (like AWS S3 or Google Cloud Storage) to store and access files.\n3. **Modify the file operation commands** to work with the cloud storage instead of the local file system.\n\n### **Current Limitations**\n\nThe current implementation doesn't distinguish between local and deployed environments, which is why you might experience issues when trying to access local files through the deployed application.\n\n---\n\nMade with ❤️ and a touch of laziness by **Yllvar**. 😄\n\n---\n\nHappy coding! 🎉\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyllvar%2Fdeepseek-engineer","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fyllvar%2Fdeepseek-engineer","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyllvar%2Fdeepseek-engineer/lists"}