Agent-Computer Interface (ACI) for OpenHands

⚠️ DEPRECATION NOTICE: This repository is now archived. The file editor tool has been migrated to the OpenHands Agent SDK under openhands/tools/str_replace_editor.

An Agent-Computer Interface (ACI) designed for software development agents OpenHands. This package provides essential tools and interfaces for AI agents to interact with computer systems for software development tasks.

Features

• Code Editor Interface: Sophisticated editing capabilities through the editor module

  • File creation and modification
  • Code editing
  • Configuration management

• Code Linting: Built-in linting capabilities via the linter module

  • Tree-sitter based code analysis
  • Python-specific linting support

• Utility Functions: Helper modules for common operations

  • Shell command execution utilities
  • Diff generation and analysis
  • Logging functionality

Installation

pip install openhands-aci

Or using Poetry:

poetry add openhands-aci

Project Structure

openhands_aci/
├── editor/           # Code editing functionality
├── linter/           # Code linting capabilities
└── utils/            # Utility functions

Development

1. Clone the repository:

git clone https://github.com/All-Hands-AI/openhands-aci.git
cd openhands-aci

2. Install development dependencies:

poetry install --extras llama

3. Configure pre-commit-hooks

make install-pre-commit-hooks

4. Run tests:

poetry run pytest

License

This project is licensed under the MIT License.