Date: January 2026 Status: Legacy Codebase Frozen Last Version: v0.46.0
The monolithic OpenAdapt codebase in this repository has been frozen as of version 0.46.0. Active development has moved to a new modular meta-package architecture that provides better maintainability, faster iteration, and cleaner separation of concerns.
This codebase remains available for:
- Reference and historical purposes
- Existing users who need to maintain current installations
- Migration planning and compatibility testing
No new features will be added to this codebase.
| Property | Value |
|---|---|
| Version | 0.46.0 |
| PyPI Package | openadapt==0.46.0 |
| Python Support | 3.10 - 3.11 |
| Release Date | February 2025 |
| Repository | https://github.com/OpenAdaptAI/OpenAdapt |
To install the legacy version (Python 3.10 or 3.11):
A plain pip install openadapt==0.46.0 fails. Its openai-whisper dependency
ships only as source and imports pkg_resources, which setuptools 81 and later
no longer include. Cap setuptools for the build:
python3.11 -m venv .venv
.venv/bin/python -m pip install --upgrade pip
echo 'setuptools<81' > build-constraints.txt
.venv/bin/python -m pip install --build-constraint build-constraints.txt openadapt==0.46.0--build-constraint needs pip 25.3 or later, which the second line installs.
On 2026-10-14 these steps installed v0.46.0 with Python 3.11 on macOS (Apple
silicon). A dry run (--dry-run) also succeeded with Python 3.10. PyPI doesn't
offer v0.46.0 on Python 3.12 or later. The runs are recorded in
legacy-install-evidence.md.
To read the source, check out the v0.46.0 tag. The main branch now
holds the 1.x launcher, and legacy/ keeps a frozen copy of the old source:
git clone --branch v0.46.0 https://github.com/OpenAdaptAI/OpenAdapt.gitThe new OpenAdapt ecosystem is split into focused, independently-versioned packages:
| Package | Description | Installation |
|---|---|---|
| openadapt | Meta-package (unified CLI + re-exports) | pip install openadapt (v1.0.0+) |
| openadapt-ml | ML engine, training, inference | pip install openadapt-ml |
| openadapt-capture | Event recording and storage | pip install openadapt-capture |
| openadapt-evals | Benchmark evaluation infrastructure | pip install openadapt-evals |
| openadapt-viewer | HTML visualization components | pip install openadapt-viewer |
| openadapt-grounding | UI element localization (optional) | pip install openadapt-grounding |
| openadapt-retrieval | Multimodal demo retrieval (optional) | pip install openadapt-retrieval |
Quick start with new packages:
# Install everything
pip install openadapt[all]
# Or install what you need
pip install openadapt-ml openadapt-captureBefore (Legacy v0.46.0):
from openadapt.record import record
from openadapt.replay import replay
from openadapt.models import Recording, ActionEvent
from openadapt.strategies.visual import VisualReplayStrategyAfter (New Architecture v1.0.0+):
# Recording
from openadapt import CaptureSession, Recorder
# ML (training and inference)
from openadapt import AgentPolicy
from openadapt_ml.training import train_supervised
# Evaluation
from openadapt import ApiAgent, evaluate_agent_on_benchmark
# Viewer
from openadapt import PageBuilderThe legacy PySide6-based tray application is not included in the new packages. Options:
- Continue using legacy: Pin to
openadapt==0.46.0and install it as shown above - Use CLI: The new
openadaptCLI provides all core functionality - Future: A new cross-platform application is planned
Legacy code: the legacy codebase takes no new features. Read it at the
v0.46.0 tag (git clone --branch v0.46.0 https://github.com/OpenAdaptAI/OpenAdapt.git) or under legacy/.
New development setup:
# Clone specific sub-package
git clone https://github.com/OpenAdaptAI/openadapt-ml
cd openadapt-ml
uv sync # or pip install -e ".[dev]"Database format changed:
| Legacy | New |
|---|---|
SQLite database (openadapt.db) |
JSON/Parquet captures |
Recording SQLAlchemy model |
Capture Pydantic model |
ActionEvent with foreign keys |
ActionEvent standalone |
A migration script will be provided to convert legacy recordings to the new format.
| Legacy CLI | New CLI |
|---|---|
python -m openadapt.record "task" |
openadapt capture start --name "task" |
python -m openadapt.replay visual |
openadapt replay --strategy visual |
python -m openadapt.visualize |
openadapt capture view <name> |
| Legacy | New |
|---|---|
| Python 3.10 - 3.11 | Python 3.12+ |
- Each package has independent CI/CD
- Changes to
openadapt-mldon't require rebuildingopenadapt-capture - Smaller test suites per package = faster feedback
- Legacy had 80+ direct dependencies
- New packages have minimal, focused dependencies
- Optional heavy dependencies (grounding, retrieval) are truly optional
- Semantic versioning per package
- Breaking changes in ML don't force capture upgrades
- Easier to pin specific versions
- Python 3.12+ with modern typing
- Native async/await support
- Better performance
- Contributors can focus on one package
- Clear ownership and responsibility
- Smaller codebases to understand
- Install only what you need
openadapt[grounding]for UI groundingopenadapt[retrieval]for demo retrievalopenadapt[all]for everything
A: No. openadapt==0.46.0 will remain available indefinitely. New versions (1.0.0+) will be the meta-package.
A: Critical security fixes will be considered. New features should be requested against the new packages.
A: A migration tool will be provided. Contact us on Discord if you need help migrating.
A: The legacy tray app works with openadapt==0.46.0. A new cross-platform app is planned for the new architecture.
- Discord: https://discord.gg/yF527cQbDG
- GitHub Issues: https://github.com/OpenAdaptAI/OpenAdapt/issues (legacy)
- New Packages Issues: See individual package repositories
This document was created as part of the OpenAdapt modular architecture transition. The legacy codebase served the community well from 2023-2025 and its patterns inform the new design.