Metadata-Version: 2.4
Name: archaeode
Version: 0.1.0
Summary: Deterministic legacy code analysis. Your code never leaves your machine.
Author-email: Archaeode <archaeode@gmail.com>
License: Proprietary
Project-URL: Homepage, https://archaeode.com
Project-URL: Repository, https://github.com/archaeode/archaeode-app
Keywords: cobol,legacy,code-analysis,modernization,static-analysis
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Topic :: Software Development :: Quality Assurance
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Python: >=3.8
Description-Content-Type: text/markdown

# 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

```bash
# 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)
   - Get your key: https://aistudio.google.com/app/apikey
   - Add to `.env`: `GOOGLE_API_KEY=your_key_here`

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

- **Website**: [archaeode.com](https://archaeode.com)
- **Twitter**: [@archaeode](https://twitter.com/archaeode)
- **LinkedIn**: [linkedin.com/company/archaeode](https://linkedin.com/company/archaeode)
- **GitHub**: [github.com/archaeode](https://github.com/archaeode)
- **Email**: archaeode@gmail.com

---

## License

MIT License — See [LICENSE](LICENSE) for details.

---

<p align="center">
  <strong>Archaeode</strong><br>
  <em>"Unearth. Understand. Then Upgrade."</em>
</p>
