aicodebot 0.6.1.1

Your AI-powered coding companion: AI Code Bot 🤖

AI Code Bot 🤖

Your AI-powered coding companion

AICodeBot is a coding assistant designed to make your coding life easier. With capabilities to perform code reviews, manage dependencies, and even suggest improvements, think of it as your AI version of a pair programmer - a team member that accelerates the pace of development and helps you write better code.

There are lot of ways to use AICodeBot that we have planned. To start, it's a command-line tool that you can use to generate commit messages, debug code, and review code. In the future, we plan to integrate it with GitHub Actions, Slack, and other tools to make it even more useful.

⚠️ Status: This project is in its infancy with very limited features, but it already improves the software development workflow, and has a healthy Roadmap of features. ⬇

⚠️ It uses OpenAI's ChatGPT large language models, which can hallucinate and be confidently wrong. Sometimes it does dumb things, which is why we have you confirm before it does anything permanent.

We're using AICodeBot to build AICodeBot, and it's getting better all the time.️ We're looking for contributors to help us build it out. See CONTRIBUTING for more.

What it's not

aicodebot is a tool for developers, not a replacement for them. It's not going to replace your job, but it will make your job easier and more fun. It's not going to take over the world, but it will help us build a better one. See the Alignment section below for more.

It's also not a "build a site for me in 5 minutes" tool that takes a well constructed prompt and builds a scaffold for you. There are other tools for that, Instead, AICodeBot is built to work with existing code bases and help you improve them at the git-commit level. It's designed to multiply the effectiveness of capable engineers.

Current features - how you can use it

AI-Assisted Git Commit

aicodebot commit will run pre-commit for you to check syntax, and then generate a commit message for you based on the changes you've made. In about as much effort as typing "fix bug" for the commit message, you will get a high quality commit message that describes the change. It will also commit the changes for you once everything checks out.

AI-Assisted Code Review

aicodebot review will run a code review on your code and suggest improvements. By default it will look at [un]staged changes, and you can also supply a specific commit hash to review. It's goal is to suggest how to make the code better, and we've found that it often teaches us new things about our code. It's not perfect, but it's a great way to get a second set of robot eyes on your code.

AI-Assisted Debugging

aicodebot debug $command will run the command and capture the log message. It will pass the error message, stack trace, comand output, etc. to the AI and respond with some suggestions on how to fix it. It saves a trip to stackoverflow in a separate window, allowing you to stay in terminal with all the context.

AI-Assisted Code Creation (Work in Progress)

aicodebot code is a feature designed to automate coding tasks based on your instructions. It's a work in progress, but here's how it works:

1. Task Understanding: The bot collects your task instructions.
2. Planning: It devises a plan based on your task.
3. Learning: It learns necessary information by searching the internet, reading the local codebase, and researching libraries/APIs.
4. Clarification: It asks questions if any aspect of the task is unclear.
5. Code Generation: It generates code consistent with your codebase style.
6. Self-Review: It reviews and improves the generated code.
7. Code Modification: It modifies the local code, allowing you to review changes before committing.
8. Test Creation: It writes and runs unit tests for the new code, modifying the code until all tests pass.
9. Continuous Learning (v2): We plan to implement a system where the bot learns from each interaction, improving its performance over time based on feedback like code acceptance, compilation success, and test results.

This feature is a work in progress, and we're excited about its potential to boost developer productivity. If you'd like to help, see CONTRIBUTING.

Getting Started

To install AICodeBot, run:

pip install aicodebot

And then run aicodebot --help to get started.

Usage: aicodebot [OPTIONS] COMMAND [ARGS]...

Options:
  -V, --version  Show the version and exit.
  -h, --help     Show this message and exit.

Commands:
  alignment  Get a message about Heart-Centered AI Alignment ❤ + 🤖.
  commit     Generate a commit message based on your changes.
  debug      Run a command and debug the output.
  fun-fact   Get a fun fact about programming and artificial intelligence.
  review     Do a code review, with [un]staged changes, or a specified...

Open AI key setup

The first time you run it, you'll be prompted to enter your OpenAI API Key, which is required, as we use OpenAI's large language models for the AI. You can get one for free by visiting your API key settings page.

GPT-3.5 vs GPT-4

When using AICodeBot, you have the option to use either GPT-3.5 or GPT-4. While GPT-4 can often provide more accurate and detailed responses, GPT-3.5 is faster and might be sufficient for simpler tasks. We highly recommend GPT-4.

Not all OpenAI accounts have GPT-4 API access enabled. By default, AICodeBot will use GPT-4 if your OpenAI account supports it, we will check the first time you run it. Tip: If your OpenAI API does not support GPT-4, you can ask to be added to the waitlist here

Roadmap of Upcoming Features

Code Workflow Improvements

• Assisted Git Commit: Automatically generate a commit message based on the changes you've made
• Assisted Debugging: Run a command with aicodebot and it captures the log message and tries to figure out what's going on from the error message. Eventually, it could also suggest fixes for the error and make the changes for you. Try it out with aicodebot debug $command
• Code Review: Provides feedback on potential issues in code, and suggests improvements to make it better.
• Dependency Management: Updating dependencies to their latest versions with pull requests that run tests.
• Documentation Generation: Generates comprehensive documentation for code, including docstrings, README files, and wiki pages.
• Performance Optimization Suggestions: Suggests potential performance optimizations for code.
• Test Generation: Generates unit tests for code, improve test coverage.
• Integration with CI/CD pipelines: Integrates with CI/CD pipelines to automate tasks like code review, testing, and deployment (via GitHub Actions). Eventually: Fix the build automatically when there are small errors.
• Rubber Ducky Chat Bot: Helps developers think through design issues by providing a conversational interface to discuss and solve problems, using data from the current repository.
• Linting/Formatting: Checks code for linting errors and automatically fixes them where possible (via pre-commit)
• Handle GitHub Issues: Handles basic tasks that you assign to @aicodebot
• Automatically Generate ChangeLogs and Release Notes: Generates release notes and changelogs based on commit messages and code changes.

User Interfaces

• Command-line, installable via pip: aicodebot can be installed as a Python package using pip install aicodebot
• Mention the @aicodebot GitHub user: Mentioning the @aicodebot GitHub user in a comment will trigger it to perform a task, review code, or pull in an appropriate GIF.
• Callable as a GitHub action: Can be called as a GitHub action to perform tasks on GitHub repositories.
• Chat: CLI chat interface that knows the context of your codebase and can answer questions about it. No more going back and forth between ChatGPT and command-line.
• Slack Bot: Interacts with aicodebot via slack, sends notifications, performs tasks, and provides real-time assistance to developers.
• Bug Report service integrations: Listen for bug reports from Sentry, Honeybadger, and other bug reporting tools and automatically create issues, assign them to developers, and notify them via Slack. Eventually: FIX the bug automatically and notify the team.

Repository Management

• Project best practices: Suggest things like pre-commit, linting, license, CI/CD, etc. Eventually: Implement them for you.
• Handle Stale Issues: Automatically detects and handles stale issues on GitHub by nudging the responsible parties.
• Triage Incoming Issues: Provides Level 1 triage of incoming issues on GitHub, including tagging, assigning, and responding with FAQs. It could also escalate issues to human developers when necessary.
• Rate the complexity of PRs: Rates the complexity of pull requests and assigns them to developers based on their skill level and context

Fun

• Fun Facts: Provides fun facts about programming or AI. It could also share interesting news or articles related to AI and programming. Try it out with aicodebot fun-fact.
• Alignment: Gives a heart-centered inspirational message about how we can build AI in a way that aligns with humanity. Try it out with aicodebot alignment.
• Telling Jokes: We've gotta figure out how to teach LLMs about humor. :)
• Supportive Encouragement: High fives and kudos for a job well done
• GIF Reactions: Reacts to messages with relevant and fun gifs.

Alignment ❤️ + 🤖

Technology itself is amoral, it just imbues the values of the engineers who create it. We believe that AI should be built-in a way that aligns with humanity, and we're building aicodebot to help us do just that. We're building from a heart-centered space, and contributing to the healthy intersection of AI and humanity.

Development / Contributing

We'd love your help! If you're interested in contributing, here's how to get started. See CONTRIBUTING for more details.