Aider REST API - AI Pair Programming as a Service

This fork of Aider focuses on providing a REST API interface to Aider's powerful AI pair programming capabilities. While maintaining all the original CLI features, it adds a robust API layer that allows you to integrate Aider's functionality into your own applications and services.

REST API

Aider's REST API allows you to integrate AI pair programming capabilities into your applications. The API server can be started using:

python -m aider.server [aider_args]

For example, here's an advanced configuration using multiple models and features:

python -m aider.server --architect --model openrouter/anthropic/claude-3.5-sonnet:beta --editor-model openrouter/anthropic/claude-3.5-sonnet --weak-model claude-3-haiku-20240307 --cache-prompts --analytics

The server runs on http://0.0.0.0:8000 by default and provides the following endpoints:

POST /init

Initializes an Aider instance with the provided configuration.

Request body:

{
    "pretty": false  // Optional, defaults to false
}

POST /chat

Sends a message to chat with Aider.

Request body:

{
    "content": "Your message here"
}

Response includes an array of responses with different types:

• tool_output: Results from tool operations (including token usage and costs)
• error: Error messages
• warning: Warning messages
• print: General output messages
• system: System messages
• assistant: AI assistant responses

Example response with pretty=true:

{
    "responses": [
        {
            "type": "assistant",
            "message": "I'll help you create a simple Hello World program in NodeJS. Let's create a new file called `hello.js`.\n\nHere's what to put in the file:\n\n```javascript\nconsole.log(\"Hello, World!\");\n```\n\nWould you like me to create this file? Please let me know the filename and location where you'd like it created."
        },
        {
            "type": "tool_output",
            "message": "Tokens: 10k sent, 79 received. Cost: $0.03 message, $0.03 session.",
            "tokens_sent": "10000",
            "tokens_received": "79",
            "cost_message": "0.03",
            "cost_session": "0.03"
        }
    ]
}

POST /stop

Stops the Aider instance.

Acknowledgment

A special thanks to Paul Gauthier, the original creator of Aider. His innovative work in developing Aider as an AI pair programming tool has revolutionized how developers interact with AI assistants. This REST API fork builds upon his excellent foundation to extend Aider's capabilities to even more use cases.