first version

Author: jose-blockchain

DOCS.md

@@ -0,0 +1,74 @@
+# Cerebras Coding Agent
+
+## Overview
+
+The Cerebras Coding Agent is an AI-powered tool that translates natural language instructions into code changes. It acts as a bridge between human intent and code implementation, helping developers work more efficiently with their codebase.
+
+## Core Capabilities
+
+1. **Repository Analysis** - Understands codebase structure, dependencies, and patterns
+2. **Natural Language Processing** - Converts plain English instructions into actionable steps
+3. **Code Generation & Modification** - Creates or updates code based on instructions
+4. **Error Detection & Fixing** - Analyzes error messages and suggests appropriate fixes
+5. **Contextual Awareness** - Follows existing project conventions and patterns
+6. **Change Management** - Tracks modifications with option to revert changes
+
+## Architecture
+
+The agent is built on a modular architecture with four key components:
+
+- **Core Agent (CerebrasAgent)** - Central controller that manages all operations
+- **File Operations** - Handles file system interactions
+- **CLI Interface** - Command-line interface for user interaction
+- **Cerebras LLM API Integration** - Connects to AI language models
+
+## Workflow
+
+1. User provides instruction via natural language
+2. Agent analyzes repository for context
+3. Agent creates plan with file changes/shell commands
+4. User reviews and accepts/rejects changes
+5. Changes are applied to codebase
+6. Agent can validate changes with follow-up commands
+
+## Key Features
+
+### Error Handling
+
+The agent can detect, analyze, and fix errors across multiple languages:
+- Parse error output from different tools and languages
+- Identify error type, location, and root cause
+- Generate appropriate fix approaches
+- Execute and validate solutions
+
+### Context Management
+
+To work effectively with larger codebases:
+- Intelligent context compression for token optimization
+- Selective file analysis based on relevance
+- Semantic prioritization of important files
+- Intelligent parsing of key configuration files
+
+### Extension Points
+
+The agent is designed to be extensible:
+- Support for additional language/framework errors
+- Custom CLI commands
+- Integration with development tools
+
+## Usage Best Practices
+
+1. Provide clear, specific instructions
+2. Start with smaller tasks before complex ones
+3. Maintain well-organized repositories
+4. Always review suggested changes
+5. Use version control for safety
+
+## Configuration
+
+Configure via:
+- Environment variables
+- Command-line options
+- Configuration files
+
+Key settings include API key, repository path, file inclusion/exclusion patterns, and context compression options. 

LICENSE

@@ -175,18 +175,7 @@
 
    END OF TERMS AND CONDITIONS
 
-   APPENDIX: How to apply the Apache License to your work.
-
-      To apply the Apache License to your work, attach the following
-      boilerplate notice, with the fields enclosed by brackets "[]"
-      replaced with your own identifying information. (Don't include
-      the brackets!)  The text should be enclosed in the appropriate
-      comment syntax for the file format. We also recommend that a
-      file or class name and description of purpose be included on the
-      same "printed page" as the copyright notice for easier
-      identification within third-party archives.
-
-   Copyright [yyyy] [name of copyright owner]
+   Copyright 2024 Cerebras Systems
 
    Licensed under the Apache License, Version 2.0 (the "License");
    you may not use this file except in compliance with the License.
@@ -198,4 +187,4 @@
    distributed under the License is distributed on an "AS IS" BASIS,
    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
    See the License for the specific language governing permissions and
-   limitations under the License.
+   limitations under the License. 

MANIFEST.in

@@ -0,0 +1,14 @@
+include LICENSE
+include README.md
+include requirements*.txt
+recursive-include cerebras_agent *.py
+recursive-include cerebras_agent *.json
+recursive-include cerebras_agent *.yaml
+recursive-include cerebras_agent *.yml
+recursive-include cerebras_agent *.txt
+recursive-exclude tests *
+recursive-exclude * __pycache__
+recursive-exclude * *.py[cod]
+recursive-exclude * *$py.class
+recursive-exclude * .*.sw*
+recursive-exclude * .DS_Store 

README.md

@@ -1,2 +1,126 @@
-# cerebras-coding-agent
-A Cerebras AI LLM coding agent for the command line
+# Cerebras Coding Agent
+
+```
+ ██████╗ ██████╗ ██████╗ ███████╗██████╗ 
+██╔════╝██╔═══██╗██╔══██╗██╔════╝██╔══██╗
+██║     ██║   ██║██║  ██║█████╗  ██████╔╝
+██║     ██║   ██║██║  ██║██╔══╝  ██╔══██╗
+╚██████╗╚██████╔╝██████╔╝███████╗██║  ██║
+ ╚═════╝ ╚═════╝ ╚═════╝ ╚══════╝╚═╝  ╚═╝
+                                         
+ Cerebras Agent - Your AI coding assistant
+```
+
+A local agent for code development using the Cerebras API. This tool allows you to interact with your codebase through natural language, helping you understand, modify, and extend your code more efficiently.
+
+## Features
+
+- Code generation and modification based on natural language instructions
+- Repository analysis and question answering
+- Interactive command-line interface
+- Automatic error detection and fixing
+- Support for multiple programming languages and frameworks
+- Proper handling of project file structures
+
+## Installation
+
+### From PyPI (Recommended)
+
+```bash
+pip install cerebras-agent
+```
+
+### From Source
+
+```bash
+# Clone the repository
+git clone https://github.com/jio-gl/cerebras-coding-agent.git
+cd cerebras-coding-agent
+
+# Option 1: Use the installation script
+./install.sh
+
+# Option 2: Use the installation script with virtual environment
+./install.sh --venv
+
+# Option 3: Manual installation
+pip install -e .
+```
+
+## Configuration
+
+1. Get a Cerebras API key from [Cerebras Cloud](https://cloud.cerebras.ai/)
+
+2. Create a `.env` file in your project root:
+```bash
+CEREBRAS_API_KEY=your_api_key_here
+```
+
+3. Alternatively, set your API key as an environment variable:
+```bash
+export CEREBRAS_API_KEY=your_api_key_here
+```
+
+## Usage
+
+### Command Line Interface
+
+```bash
+# Start the agent in interactive mode
+cerebras-agent
+
+# Ask a specific question about the repository without making changes
+cerebras-agent --ask "How does this codebase handle authentication?"
+cerebras-agent -a "How does this codebase handle authentication?"
+
+# Prompt the agent to perform changes in the repository
+cerebras-agent --agent "Add error handling to all database functions"
+cerebras-agent -g "Add error handling to all database functions"
+
+# Specify a repository path (default: current directory)
+cerebras-agent --repo /path/to/your/repo
+cerebras-agent -r /path/to/your/repo
+```
+
+### Interactive Commands
+
+Once in the interactive mode, you can use the following commands:
+
+- **`<prompt>`**: Enter any natural language prompt to generate code changes
+- **`ask <question>`**: Ask a question about the repository without making changes
+- **`checkpoint`**: Show current checkpoint and change history
+- **`revert <number>`**: Revert to a specific checkpoint number
+- **`help`**: Show available commands
+- **`exit`**: Exit the program
+
+## Development
+
+1. Clone the repository:
+```bash
+git clone https://github.com/jio-gl/cerebras-coding-agent.git
+cd cerebras-coding-agent
+```
+
+2. Install development dependencies:
+```bash
+pip install -e ".[dev]"
+```
+
+3. Run tests:
+```bash
+./run_tests.sh
+```
+
+4. Run integration tests (requires API key):
+```bash
+export CEREBRAS_API_KEY=your_api_key_here
+./run_integration_tests.sh
+```
+
+## License
+
+This project is licensed under the Apache License 2.0 - see the [LICENSE](LICENSE) file for details.
+
+## Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request. 

cerebras_agent/__init__.py

@@ -0,0 +1,8 @@
+"""
+Cerebras Agent - A local agent for code development using Cerebras API.
+"""
+
+from .agent import CerebrasAgent
+
+__version__ = "0.1.0"
+__all__ = ["CerebrasAgent"]