Deterministic legacy code analysis. Your code never leaves your machine.
Project description
Archaeode
Unearth. Understand. Then Upgrade.
AI-powered legacy code documentation and modernization platform. Transform COBOL, C, Fortran, Java, and PL/I into modern Python 3.12+.
What is Archaeode?
Archaeode is a code archaeology platform that uses multi-AI architecture (Gemini 3.1, Claude, Ollama) to automatically document, analyze, and modernize legacy codebases. We don't just refactor — we resurrect.
Key Features
- Multi-AI Engine: Gemini 3.1 Pro + Flash with intelligent fallback to Ollama
- 3-Agent Pipeline: Generate → Review → Fix for highest accuracy
- Code Documentation: Auto-generate comprehensive docs for undocumented code
- Security Scanning: Input/output code sanitization and vulnerability detection
- On-Premise Option: Full Docker deployment with local LLM for data-sensitive industries
- REST API: Batch processing, webhooks, and programmatic access
Quick Start
# Clone the repository
git clone https://github.com/archaeode/archaeode-app.git
cd archaeode-app
# Install dependencies
pip install -r requirements.txt
# Set up environment
cp .env.example .env
# Add your Gemini API key to .env
# Launch the dashboard
streamlit run dashboard/dashboard.py
# Or launch the REST API
python -m src.api.app
Configuration
-
Google Gemini API (Required)
- Get your key: https://aistudio.google.com/app/apikey
- Add to
.env:GOOGLE_API_KEY=your_key_here
-
Supabase (Recommended for production)
- Sign up: https://supabase.com
- Add to
.env:SUPABASE_URL,SUPABASE_ANON_KEY,SUPABASE_SERVICE_ROLE_KEY
-
Development Mode
- Set
AUTH_REQUIRED=falsein.env
- Set
Supported Languages
| Input (Legacy) | Output |
|---|---|
| C (.c, .h) | Python 3.12+ |
| COBOL (.cob, .cbl) | Python 3.12+ |
| Fortran (.f90, .f) | Python 3.12+ |
| Java (.java) | Python 3.12+ |
| PL/I (.pli) | Python 3.12+ |
Modernization Metrics
| Metric | Legacy (C/COBOL) | Modern (Python 3.12) | Improvement |
|---|---|---|---|
| Lines of Code | 450+ | ~120 | 73% Reduction |
| Complexity | High (GOTO/Pointers) | Low (Modular) | Optimized |
| Security Score | 35% | 95%+ | A+ Grade |
Architecture
Archaeode Platform
├── AI Analysis Engine (Gemini 3.1 Pro/Flash + Ollama)
├── 3-Agent Pipeline (Generate → Review → Fix)
├── Code Sanitizer (Input/Output security scanning)
├── Legacy Code Parser (COBOL, C, Fortran, Java, PL/I)
├── Documentation Generator (7-component docs + validation)
├── Test Executor (Automated pytest validation)
├── REST API (Flask + rate limiting + auth)
└── Dashboard (Streamlit)
Pricing
| Tier | Price | Files/Month | Max Size | Features |
|---|---|---|---|---|
| Free | $0/forever | 5 | 50KB | Markdown export, Cloud AI |
| Pro | $49/month | 50 | 200KB | JSON/PDF export, Validation |
| Business | $199/month | 200 | 500KB | REST API, Batch processing |
| Enterprise | Custom | Unlimited | 5MB | On-premise, Local LLM, SSO |
API Endpoints
| Endpoint | Method | Auth | Description |
|---|---|---|---|
/api/v1/health |
GET | No | Health check |
/api/v1/modernize |
POST | API Key | Modernize single file |
/api/v1/analyze |
POST | API Key | Analyze legacy code |
/api/v1/batch |
POST | API Key | Batch modernization (Business+) |
/api/v1/documentation |
POST | Session | Generate documentation |
/api/v1/roi |
POST | No | Calculate ROI |
Contact
- Website: archaeode.com
- Twitter: @archaeode
- LinkedIn: linkedin.com/company/archaeode
- GitHub: github.com/archaeode
- Email: archaeode@gmail.com
License
MIT License — See LICENSE for details.
Archaeode
"Unearth. Understand. Then Upgrade."
Project details
Release history Release notifications | RSS feed
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 archaeode-0.1.0.tar.gz.
File metadata
- Download URL: archaeode-0.1.0.tar.gz
- Upload date:
- Size: 124.7 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.13.1
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
d7bec5261a26468c40ccca33fa5ce4ac5eed2e8bf9f6a0dc3b0942aa9a0cd7f3
|
|
| MD5 |
750ce066f8254aab39451074b98b55dc
|
|
| BLAKE2b-256 |
09c130d5414efd836876595d2eac4f0cf4214f74dc22a1aa3c966be06bad6820
|
File details
Details for the file archaeode-0.1.0-py3-none-any.whl.
File metadata
- Download URL: archaeode-0.1.0-py3-none-any.whl
- Upload date:
- Size: 134.4 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.13.1
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
ddf26128b5511e53868e0440edcf98aa0f51571628581a58cf9674d45fab2c81
|
|
| MD5 |
c6336b5a8e65648b7c2571867da38a55
|
|
| BLAKE2b-256 |
81d7b1a9aa0fd639bdc9a7496106a6ef06288587aa2ea43404d3da89a23f2ff2
|