Skip to main content

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

  1. Google Gemini API (Required)

  2. Supabase (Recommended for production)

    • Sign up: https://supabase.com
    • Add to .env: SUPABASE_URL, SUPABASE_ANON_KEY, SUPABASE_SERVICE_ROLE_KEY
  3. Development Mode

    • Set AUTH_REQUIRED=false in .env

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


License

MIT License — See LICENSE for details.


Archaeode
"Unearth. Understand. Then Upgrade."

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

archaeode-0.1.0.tar.gz (124.7 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

archaeode-0.1.0-py3-none-any.whl (134.4 kB view details)

Uploaded Python 3

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

Hashes for archaeode-0.1.0.tar.gz
Algorithm Hash digest
SHA256 d7bec5261a26468c40ccca33fa5ce4ac5eed2e8bf9f6a0dc3b0942aa9a0cd7f3
MD5 750ce066f8254aab39451074b98b55dc
BLAKE2b-256 09c130d5414efd836876595d2eac4f0cf4214f74dc22a1aa3c966be06bad6820

See more details on using hashes here.

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

Hashes for archaeode-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 ddf26128b5511e53868e0440edcf98aa0f51571628581a58cf9674d45fab2c81
MD5 c6336b5a8e65648b7c2571867da38a55
BLAKE2b-256 81d7b1a9aa0fd639bdc9a7496106a6ef06288587aa2ea43404d3da89a23f2ff2

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page