---
id: openhands-aci
version: "0.3.3"
license: MIT
license_treatment: permissive
maintenance: active
---

# openhands-aci — An Agent-Computer Interface (ACI) designed for software development agents OpenHands.

License: permissive · Maintenance: active · Downloads: 1.3M/mo

## What it is and what it does

OpenHands ACI is a toolkit designed to let AI agents perform software development tasks by interacting with code and files. It wraps three main capabilities: a code editor module for creating and modifying files, a linter module for analyzing code quality using tree-sitter, and utility functions for shell commands, diffs, and logging. The package depends on a large ecosystem of libraries for document parsing (PDF, Excel, PowerPoint), audio processing, and code analysis.

The package is now archived and its functionality has been migrated to the OpenHands Agent SDK. If you are starting a new project, the SDK is the recommended target. This package remains installable and active but should be considered a legacy interface for existing integrations or agents built on the original OpenHands framework.

Use it for:

- Building AI agents that need to read, create, and modify source code files as part of automated development workflows.
- Integrating code linting and analysis into agent-based code review or refactoring systems.
- Providing agents with utilities to execute shell commands and generate diffs for version control integration.
- Prototyping agent-based development tools that require file editing and code quality checks.
- Migrating legacy OpenHands agent implementations that depend on this ACI interface.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Provides tools and interfaces for AI agents to interact with computer systems for software development tasks, including code editing, linting, and utility functions for file manipulation and analysis.

Yes, with conditions. Install if you are maintaining or extending an existing OpenHands agent that already depends on this package. The low install friction and permissive license make it straightforward to add. However, do not start new projects with it—the package is archived and its functionality has moved to the OpenHands Agent SDK. The 28 runtime dependencies are substantial; evaluate whether you need all of them (document parsing, audio, graphics) for your use case.

## Install

pip install openhands-aci
uv add openhands-aci
poetry add openhands-aci

## Installing openhands-aci

Before you install: Low install friction with a pure Python wheel distribution. Marked active with recent release activity. Carries 28 runtime dependencies including heavy libraries (pandas, matplotlib, pydub, speechrecognition), which may add setup complexity despite the wheel format.

License in practice: MIT license is permissive; you can use, modify, and distribute this package freely with minimal restrictions, making it suitable for both open-source and commercial projects.

Quickstart:

pip install openhands-aci

from openhands_aci.editor import editor
from openhands_aci.linter import linter

# Use editor and linter modules for code operations

Requires Python 3.12 or later (supports 3.12, 3.13, 3.14). The package is archived and has been migrated to the OpenHands Agent SDK; new development should target that instead.

Verify before relying:

- Specific API surface and method signatures for the editor and linter modules are not detailed in the fact sheet.
- Whether the archived status affects long-term maintenance or security updates beyond the current release.
- Performance characteristics when handling large codebases or complex linting tasks.

## Package facts

- License: MIT (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 1.3M/month (top 5,000 on PyPI)
- Known vulnerabilities: none known

## Tags

ai agent code editing interface, software development agent tools, code linting for agents, agent computer interface, automated code modification, agent-based file operations, ai development tools, agent-framework, code-editing, archived

[View on SkillFed](https://skillfed.io/packages/openhands-aci) · [View on PyPI](https://pypi.org/project/openhands-aci/)