Metadata-Version: 2.3
Name: openhands-aci
Version: 0.2.13
Summary: An Agent-Computer Interface (ACI) designed for software development agents OpenHands.
License: MIT
Author: OpenHands
Requires-Python: >=3.12,<4.0
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Requires-Dist: binaryornot (>=0.4.4,<0.5.0)
Requires-Dist: cachetools (>=5.5.2,<6.0.0)
Requires-Dist: charset-normalizer (>=3.4.1,<4.0.0)
Requires-Dist: flake8
Requires-Dist: gitpython
Requires-Dist: grep-ast (==0.3.3)
Requires-Dist: pydantic (>=2.11.3,<3.0.0)
Requires-Dist: tree-sitter (>=0.24.0,<0.25.0)
Requires-Dist: tree-sitter-javascript (>=0.23.1,<0.24.0)
Requires-Dist: tree-sitter-python (>=0.23.6,<0.24.0)
Requires-Dist: tree-sitter-ruby (>=0.23.1,<0.24.0)
Requires-Dist: tree-sitter-typescript (>=0.23.2,<0.24.0)
Requires-Dist: whatthepatch (>=1.0.6,<2.0.0)
Description-Content-Type: text/markdown

# Agent-Computer Interface (ACI) for OpenHands

An Agent-Computer Interface (ACI) designed for software development agents [OpenHands](https://github.com/All-Hands-AI/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

```bash
pip install openhands-aci
```

Or using Poetry:

```bash
poetry add openhands-aci
```

## Project Structure

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

## Development

1. Clone the repository:
```bash
git clone https://github.com/All-Hands-AI/openhands-aci.git
cd openhands-aci
```

2. Install development dependencies:
```bash
poetry install
```

3. Configure pre-commit-hooks
```bash
make install-pre-commit-hooks
```

4. Run tests:
```bash
poetry run pytest
```

## License

This project is licensed under the MIT License.

