Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/bigsk1/claude-plus
Claude Plus is an advanced AI-powered development assistant that combines the capabilities of Anthropic's Claude AI with a suite of development tools.
https://github.com/bigsk1/claude-plus
ai ai-assistant ai-engineering ai-search anthropic anthropic-claude chatbot claude-ai claude-api developer-tools fastapi homelab llm-agent searxng self-hosted tavily
Last synced: 15 days ago
JSON representation
Claude Plus is an advanced AI-powered development assistant that combines the capabilities of Anthropic's Claude AI with a suite of development tools.
- Host: GitHub
- URL: https://github.com/bigsk1/claude-plus
- Owner: bigsk1
- License: other
- Created: 2024-07-07T16:24:01.000Z (6 months ago)
- Default Branch: main
- Last Pushed: 2024-12-05T01:20:56.000Z (23 days ago)
- Last Synced: 2024-12-05T02:23:00.062Z (23 days ago)
- Topics: ai, ai-assistant, ai-engineering, ai-search, anthropic, anthropic-claude, chatbot, claude-ai, claude-api, developer-tools, fastapi, homelab, llm-agent, searxng, self-hosted, tavily
- Language: Python
- Homepage: https://bigsk1.com
- Size: 1.1 MB
- Stars: 10
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
# Claude Plus : AI-Powered Development Assistant
Claude Plus is an advanced AI-powered development assistant that combines the capabilities of Anthropic's Claude AI with a suite of development tools. It's designed to help developers with various tasks, from coding to project management, all through an interactive chat interface.
## Features
- 🧠 **Interact with Claude-3.5-Sonnet**: Engage with the advanced AI, ask to build your ideas and code files and folders are made!.
- 📁 **File System Manipulation**: Claude will create, read, write and delete files and folders seamlessly on your system. The files tab shows date modified and size of files and folders in a list or grid view.
- 🔍 **Powerful Search**: Utilize Tavily API or SearXNG to perform comprehensive searches. Claude also has search tool built in.
- 💡 **Code Snippet Management**: Highlight and manage code snippets efficiently. Have questions about an existing project drop the folder in the projects directory and Claude will have full access.
- 📂 **Project Structure Management**: Build and maintain complex project structures with ease.
- 🔧 **Code Analysis and Suggestions**: Receive detailed analysis and improvement suggestions for your code.
- 🖼️ **Image Analysis**: Analyze images and gain insights with AI-powered image support.
- ⚙️ **Automode**: Automate tasks for increased efficiency and productivity. Set max iterations in env and Claude will cycle through that number of times automaticlly.
- 🔄 **Iterative Tracking**: Monitor changes and iterations accurately during automode sessions.
- ✂️ **Diff-Based Editing**: Edit files using diff-based techniques for precise modifications.
- 💻 **NEW console** feature - You are able to run commands in the UI just like a terminal. Run python scripts within the UI!
- ⬇️ **NEW download projects folder** You can download the entire projects directory with all your created folders and files directly from the UI now.
This application leverages the power of Claude to enhance your development workflow, providing robust tools for file management, search, code analysis, and automation.
## Getting Started
### Prerequisites
- Python 3.10+
- Node.js 18+
- Anthropic API key
- Tavily API key or SearXNG server
### Installation
1. Clone the repository:
```
git clone https://github.com/bigsk1/claude-plus.git
cd claude-plus
```
2. Set up the backend:
```
python -m venv venv
source venv/bin/activate # On Windows use `venv\Scripts\activate`
pip install -r requirements.txt
```
3. Set up the frontend:
```
cd frontend
npm install
```
4. Create a `.env` file in the root directory and add your API keys:
```env
ANTHROPIC_API_KEY=your_anthropic_api_key
CLAUDE_MODEL=claude-3-5-sonnet-20240620
SEARCH_PROVIDER=SEARXNG # or TAVILY
TAVILY_API_KEY=your_tavily_api_key # If using Tavily
SEARXNG_URL=http://192.168.1.10:4000 # If using SearXNG
SEARXNG_RESULTS=5 # number of returned search results
MAX_ITERATIONS=5 # Number of automode iterations
```
### Running the Application
1. Start the backend server:
```
uvicorn backend:app --host 0.0.0.0 --port 8000
```
2. In a new terminal, start the frontend development server from the frontend folder:
```
cd frontend
npm run dev
```
3. Open your browser and navigate to `http://localhost:5173/`
## Usage
Claude Plus offers a powerful suite of features to enhance your development workflow. Here's how to make the most of this AI-powered assistant:
### 1. Interactive Chat Interface
- **Engage with Claude**: Use the chat interface to communicate with Claude, your AI development assistant.
- **Natural Language Queries**: Ask questions, request code explanations, or seek advice on best practices.
- **Code Generation**: Describe the functionality you need, and Claude will generate code snippets or entire files.
- **Debugging Assistance**: Paste error messages or problematic code for Claude to analyze and suggest fixes.
### 2. File and Image Management
- **File Upload**: Easily upload files for Claude to analyze or work with. All uploaded files are stored in the `projects/uploads` folder.
- **Image Analysis**: Upload images for Claude to describe and analyze, useful for UI/UX discussions or diagram interpretations.
- **Code Review**: Upload your code files for Claude to review, suggest improvements, or explain complex sections. It will not only read your files you add but can modify and even delete if requested.
### 3. Project Structure Management
- **File Explorer**: Use the intuitive file explorer interface to manage your project structure directly in the UI.
- **Create**: Add new files or folders to organize your project.
- **Edit**: Modify existing files with syntax highlighting for various programming languages.
- **Delete**: Remove unnecessary files or folders to keep your project clean.
- **Real-time Updates**: All changes in the file explorer are immediately reflected in the `projects` folder.
### 4. Automode for Autonomous Development
- **Activate Automode**: Enable Claude to work autonomously on complex tasks or entire project setups.
- **Project Generation**: Describe a project idea, and watch as Claude creates folder structures, files, and boilerplate code.
- **Iterative Development**: Claude can refine and expand code over multiple iterations without constant user input.
- **Progress Tracking**: Monitor Claude's progress as it works through tasks in automode.
- **Sandbox Environment**: All automode operations are confined to the `projects` folder, ensuring safe experimentation.
### 5. Web Search Integration
- **Integrated Search**: Perform web searches without leaving the chat interface.
- **Multiple Providers**: Choose between SEARXNG (for privacy-focused searches) or Tavily (for AI-enhanced results).
- **Rich Markdown Display**: Search results are presented in a readable, formatted markdown style.
- **Context-Aware Queries**: Claude can perform searches based on your conversation context for more relevant results.
### 6. Code Execution and Testing (In Progress)
- **Secure Sandbox**: Run Python scripts directly within the chat interface.
- **Output Display**: View the results of your code execution inline with your conversation.
- **Interactive Debugging**: Step through code with Claude's guidance to identify and fix issues.
### 7. Version Control Integration (Coming Soon)
- **Git Commands**: Perform basic git operations like commit, push, and pull directly from the chat.
- **Commit Message Assistance**: Let Claude suggest meaningful commit messages based on your changes.
- **Chat History**: Review past conversations and decisions with a searchable chat history.
Remember, Claude Plus is continuously learning and improving. Don't hesitate to experiment with different approaches and let us know about your experience!
## Docker
This project includes a Docker configuration
### Docker quick start
Set your .env correctly in root
cd into docker folder
```yaml
docker-compose up -d
```
Frontend: http://localhost:5173
You can always get the latest image by:
```bash
docker pull ghcr.io/bigsk1/claude-plus:latest
```
### Local Docker Setup
1. Ensure Docker and Docker Compose are installed on your system.
2. Navigate to the project root directory.
3. Build and run the development containers:
```
docker-compose -f docker/docker-compose.dev.yml up -d --build
```
4. Access the application:
- Frontend: http://localhost:5173
The development setup includes hot-reloading for both frontend and backend, and maps the `projects` folder to persist data.
## VS Code Dev Container Setup
This project also includes a configuration for development using VS Code's Remote - Containers extension.
### Prerequisites
- Visual Studio Code
- Docker Desktop
- Remote - Containers extension for VS Code
### Setup
1. Open the project folder in VS Code.
2. When prompted, click "Reopen in Container", or use the Command Palette (F1) and select "Remote-Containers: Reopen in Container".
3. VS Code will build the dev container and reload the window with the project open inside the container.
### Features
- Python 3.12 and Node.js 18 pre-installed
- All project dependencies automatically installed
- Pre-configured linting and formatting tools
- Automatic port forwarding for backend (8000) and frontend (5173)
- Unified development environment across different machines
### Usage
Once inside the dev container:
1. The backend server will start automatically on port 8000.
2. The frontend development server will start automatically on port 5173.
3. You can edit files as normal, and changes will be reflected immediately due to volume mounting.
4. Use the integrated terminal in VS Code to run additional commands if needed.
Note: The first time you open the project in the dev container, it may take a few minutes to build. Subsequent loads will be much faster.
## Contributing
We welcome contributions to Claude Plus! This project is in active development, and things may change rapidly and break and be buggy! Here's how you can contribute:
1. Fork the repository
2. Create your feature branch (`git checkout -b feature/AmazingFeature`)
3. Commit your changes (`git commit -m 'Add some AmazingFeature'`)
4. Push to the branch (`git push origin feature/AmazingFeature`)
5. Open a Pull Request
Please make sure to test all your features so they do not inadvertently cause another issue.
## Disclaimer
This project is under active development. Features may change, and there might be bugs or unexpected behavior. Use at your own risk in production environments.
## Acknowledgments
- Anthropic for the Claude AI model
- Tavily for the search API
- SearXNG for there privacy focus search
- For giving me the idea for building a web version based on the ideas of a cli version https://github.com/Doriandarko/claude-engineer