Atlas: Legacy to Modern code modernization
Project description
ATLAS: Autonomous Transpilation for Legacy Application Systems
ATLAS is an open-source, AI coding agent that helps you modernize legacy codebases into modern programming languages within your terminal.
Status: Paper in progress
Features
- Modern TUI: Clean terminal interface with brand-colored UI elements
- Multi-Provider Support: Works with OpenAI, Anthropic, DeepSeek, Gemini, and 100+ other LLM providers via LiteLLM
- Interactive Chat: Natural conversation with your codebase - ask questions, request changes, and get AI assistance
- File Management: Add files to context, drop them when done, view what's in your chat session
- Git Integration: Automatic commits, undo support, and repository-aware context
- Streaming Responses: Real-time AI responses with markdown rendering
- Session History: Persistent conversation history across sessions
Quick Start
Prerequisites
- Python 3.14+
- BYOK for your preferred LLM provider (OpenAI, Anthropic, etc.)
Installation
curl -fsSL https://astrio.app/atlas/install | bash
or
pip install astrio-atlas
Set Up API Keys
To set up your API key, create a .env file at the root of your project and add your provider key(s):
# Example for OpenAI:
OPENAI_API_KEY=sk-...
# Example for Anthropic:
ANTHROPIC_API_KEY=sk-ant-...
# Example for DeepSeek:
DEEPSEEK_API_KEY=...
# Add other providers as needed
You can quickly start by copying the example environment file:
cp .env.example .env
Usage
# Start the interactive CLI
atlas
Documentation
- Getting Started - Installation and quick start guide
- Full Documentation - Complete documentation index
License
This project is licensed under the Apache-2.0 License. See the LICENSE file for details.
Security
For security vulnerabilities, please email naingoolwin.astrio@gmail.com instead of using the issue tracker. See SECURITY.md for details.
Contributing
We welcome all contributions — from fixing typos to adding new language support! See CONTRIBUTING.md for setup instructions, coding guidelines, and how to submit PRs.
Community & Support
- Follow our project updates on X
- Join our Discord
- Join the discussion: GitHub Discussions
- Report bugs: GitHub Issues
Contact Us
For partnership inquiries or professional use cases:
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file astrio_atlas-0.3.5.tar.gz.
File metadata
- Download URL: astrio_atlas-0.3.5.tar.gz
- Upload date:
- Size: 216.8 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.7
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
bf6dbbf861ab695636f880ddce453ac8f2f36514cbd9aadd216fa308519242ed
|
|
| MD5 |
ea8d0d9be901570a13a2affb4942aa4a
|
|
| BLAKE2b-256 |
89df4b4b53a281584381b5908c8635a9116c708e7437655ce226e4900d015305
|
Provenance
The following attestation bundles were made for astrio_atlas-0.3.5.tar.gz:
Publisher:
pypi-publish.yml on astrio-ai/atlas
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
astrio_atlas-0.3.5.tar.gz -
Subject digest:
bf6dbbf861ab695636f880ddce453ac8f2f36514cbd9aadd216fa308519242ed - Sigstore transparency entry: 855192879
- Sigstore integration time:
-
Permalink:
astrio-ai/atlas@5bd7ed0ca281249ac47822d25e57812ca78e330b -
Branch / Tag:
refs/tags/v0.3.5 - Owner: https://github.com/astrio-ai
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
pypi-publish.yml@5bd7ed0ca281249ac47822d25e57812ca78e330b -
Trigger Event:
push
-
Statement type:
File details
Details for the file astrio_atlas-0.3.5-py3-none-any.whl.
File metadata
- Download URL: astrio_atlas-0.3.5-py3-none-any.whl
- Upload date:
- Size: 267.5 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.7
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
ea59b05d8e71d2a59c52b272201396844f4f98fcc8b13418c13e22f725210939
|
|
| MD5 |
c5be22657becded8a8b6fe0f85b63768
|
|
| BLAKE2b-256 |
a463cf8837dee14bfeddf3b4171159f0acb5789da2153e31877445bd30dc1adc
|
Provenance
The following attestation bundles were made for astrio_atlas-0.3.5-py3-none-any.whl:
Publisher:
pypi-publish.yml on astrio-ai/atlas
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
astrio_atlas-0.3.5-py3-none-any.whl -
Subject digest:
ea59b05d8e71d2a59c52b272201396844f4f98fcc8b13418c13e22f725210939 - Sigstore transparency entry: 855192885
- Sigstore integration time:
-
Permalink:
astrio-ai/atlas@5bd7ed0ca281249ac47822d25e57812ca78e330b -
Branch / Tag:
refs/tags/v0.3.5 - Owner: https://github.com/astrio-ai
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
pypi-publish.yml@5bd7ed0ca281249ac47822d25e57812ca78e330b -
Trigger Event:
push
-
Statement type: