2026 Projects Ecosystem Survey

Comprehensive Status Report - January 2026

Author

AI Platform Coordination

Published

January 20, 2026

Executive Summary

This survey documents the complete state of the 2026project ecosystem as of January 2026, providing a comprehensive overview of all 32 projects, their documentation status, port assignments, and development activity.

Key Statistics

Metric	Count
Total Projects	32
Active Projects	19
With Quarto Documentation	15
With README	16
Deprecated/Legacy	4
Experimental	9
Port Assignments (5000-5999)	28

Health Overview

🟢 Production Ready: 6 core packages (ai-korrespondenz, ai-voicememo, ai-scholar, ai-viewer, ai-agenda, ai-core)
🟡 Active Development: 13 secondary packages with ongoing work
🔴 Needs Attention: 4 projects missing README, 17 without Quarto docs
⚠️ Migration Required: 8 projects still using setuptools, 15 projects below Python 3.12

Project Categories

Core Infrastructure (6 projects)

These form the foundation of the ecosystem:

ai-korrespondenz

Status: 🟢 Production
Port: 5300 (API), 5301 (Docs)
Purpose: Unified correspondence management (Gmail, Thunderbird, phone, notes, voice memos)
Version: 1.0.0
Python: >=3.11 (migrate to 3.12)
Build: ✅ hatchling
Documentation: ✅ README, ✅ Quarto
Features: MCP server, REST API, multi-source sync, agenda system
Activity: 🟢 Recent (2026-01-19)
Code Size: 60 Python files

ai-voicememo

Status: 🟢 Production
Port: 5200 (Web), 5201 (Docs), 5210 (Legacy API)
Purpose: Voice memo sync, classification, transcription with AI
Version: 0.1.0
Python: >=3.10 (migrate to 3.12)
Build: ⚠️ setuptools (migrate to hatchling)
Documentation: ✅ README, ✅ Quarto, ✅ Reports system
Features: MCP server, web dashboard, reports generation, classification
Activity: 🟢 Recent (2026-01-19)
Code Size: 45 Python files
Note: Most mature reports system - template for other projects

ai-scholar

Status: 🟢 Production
Port: 5110 (Service), 5111 (Docs)
Purpose: PDF/OCR processing with AI (Gemini, Ollama)
Version: 3.0.0
Python: >=3.10 (migrate to 3.12)
Build: ✅ hatchling
Documentation: ✅ README, ✅ Quarto
Features: Multi-model support, PDAI format, complete pipeline
Activity: 🟢 Active (2026-01-15)
Code Size: 52 Python files

ai-viewer

Status: 🟢 Production
Port: 5100 (Service), 5101 (Docs)
Purpose: Universal document viewer for PDAI documents
Version: 1.0.0
Python: >=3.8 (migrate to 3.12)
Build: ⚠️ setuptools (migrate to hatchling)
Documentation: ✅ README, ✅ Quarto
Features: Web interface, PDAI format support
Activity: 🟢 Active (2026-01-15)
Code Size: 9 Python files

ai-agenda

Status: 🟢 Production
Port: 5520 (Service), 5521 (Docs)
Purpose: Agenda and project management with multi-location support
Version: 1.0.0
Python: >=3.11 (migrate to 3.12)
Build: ✅ hatchling
Documentation: ✅ README, ✅ Quarto
Features: Project tracking, location management
Activity: 🟢 Active (2026-01-15)
Code Size: 25 Python files

ai-core

Status: 🟢 Production
Port: N/A (library)
Purpose: Shared infrastructure - orchestrator, AI clients, pdai library
Version: 1.0.0
Python: >=3.10 (migrate to 3.12)
Build: ⚠️ setuptools (migrate to hatchling)
Documentation: ✅ README, ❌ Quarto (should add)
Features: Gemini/Ollama clients, PDAI document model, orchestrator
Activity: 🟢 Active (2026-01-15)
Code Size: 25 Python files
Note: Foundation package, many projects depend on it

Document Processing (4 projects)

ai-ocr

Status: 🟡 Active
Port: Not assigned
Purpose: Multistage PDF OCR processing pipeline
Version: 1.0.0
Python: >=3.8 (migrate to 3.12)
Build: ⚠️ setuptools
Documentation: ✅ README, ✅ Quarto
Activity: 🟢 Active
Code Size: 18 Python files

ai-lector

Status: 🟡 Active
Port: 5400 (Service), 5401 (Docs)
Purpose: Text interpretation and editing system
Version: 1.0.0
Python: >=3.8 (migrate to 3.12)
Build: ⚠️ setuptools
Documentation: ❌ README (needs creation), ✅ Quarto
Features: Web interface
Activity: 🟢 Active
Code Size: 148 Python files (large project)

ai-translation

Status: 🟡 Experimental
Port: 5410 (assigned but unused)
Purpose: Scholarly XML translation (Latin to English)
Version: N/A
Python: N/A
Build: ❌ No package config
Documentation: ✅ README, ❌ Quarto
Activity: 🟡 Minimal
Code Size: 4 Python files

ai-karman-manager

Status: 🟡 Project-specific
Port: Not assigned
Purpose: Theodor von Karman archive digitization
Version: 1.0.0
Python: >=3.8
Build: ⚠️ setuptools
Documentation: ✅ README, ❌ Quarto
Activity: 🟡 Stable
Code Size: 7 Python files

Communication & Media (7 projects)

ai-reporter

Status: 🟢 Active
Port: 5510 (Service), 5511 (Docs)
Purpose: Automated audio transcription and publishing
Version: 3.5.4
Python: >=3.10 (migrate to 3.12)
Build: ⚠️ setuptools
Documentation: ✅ README, ✅ Quarto
Activity: 🟢 Active
Code Size: 35 Python files

ai-foto

Status: 🟢 Active
Port: 5700 (Service), 5701 (Docs)
Purpose: Semantic photo analysis with 2D segmentation
Version: 0.1.0
Python: >=3.10 (migrate to 3.12)
Build: ✅ hatchling
Documentation: ✅ README, ✅ Quarto
Activity: 🟢 Active
Code Size: 20 Python files

ai-nepi2

Status: 🟢 Project-specific (Large)
Port: Not assigned (multimedia project)
Purpose: Conference presentation processing with video/PDF sync
Version: N/A
Python: N/A
Build: ❌ No package (script collection)
Documentation: ❌ No root README, ❌ No Quarto
Features: Complex pipeline, multiple subdirs with docs
Activity: 🟢 Very Active
Code Size: Large (diagnostic/, performance/, function/ subdirs)
Note: Needs root README and consideration for Quarto docs

ai-komparativ-transkription

Status: 🟡 Experimental
Port: 5051 (Docs)
Purpose: Comparative transcription analysis
Version: 0.3.0
Python: >=3.9
Build: ⚠️ setup.py (migrate to pyproject.toml + hatchling)
Documentation: ❌ README (needs creation), ✅ Quarto
Activity: 🟡 Active
Code Size: 11 Python files

ai-audio

Status: 🟡 Experimental
Port: 5230 (assigned)
Purpose: Audio transcription
Version: 1.0.0
Python: >=3.8
Build: ⚠️ setup.py
Documentation: ❌ README, ❌ Quarto
Activity: 🟡 Active
Code Size: 45 Python files

ai-dictation

Status: 🟡 Experimental
Port: 5220 (assigned)
Purpose: QMD dictation experiments
Version: 0.1.0
Python: >=3.9
Build: ⚠️ setuptools
Documentation: ❌ README, ❌ Quarto
Activity: 🟡 Minimal
Code Size: 5 Python files

ai-symphony

Status: 🟡 Experimental
Port: Not assigned
Purpose: AI instruction pipeline orchestration
Version: 1.0.0
Python: >=3.8
Build: ⚠️ setuptools
Documentation: ✅ README, ❌ Quarto
Activity: 🟡 Stable
Code Size: 23 Python files

Apple Ecosystem (3 projects)

ai-apple

Status: 🟡 Active
Port: 5600 (Main), 5610 (Catalog), 5620 (Memo)
Purpose: Apple ecosystem integration (Notes, Reminders)
Version: 0.2.0
Python: >=3.9
Build: ⚠️ setuptools
Documentation: ❌ README (needs creation), ❌ Quarto
Activity: 🟢 Very Active
Code Size: 1504 Python files (very large)
Note: Needs documentation urgently given size

apple-notes

Status: 🟢 Active
Port: 5630 (assigned)
Purpose: AI-powered revision system for Apple Notes
Version: 0.1.0
Python: >=3.11
Build: ✅ hatchling
Documentation: ✅ README, ❌ Quarto (should add)
Features: Web interface, Bauhaus design
Activity: 🟢 Active
Code Size: 5 Python files

ai-apple-documents

Status: 🔴 Deprecated
Port: N/A
Purpose: Apple document sources (superseded by ai-korrespondenz)
Action: Move to deprecated/ folder
Documentation: ❌ README, ❌ Quarto
Code Size: 2 Python files

Cluster & Infrastructure (4 projects)

ai-cluster

Status: 🟢 Active
Port: 5800 (API), 5810 (Manager), 5820 (Satellite), 5830 (Dashboard), 5840 (Flower), 5850 (Orchestrator)
Purpose: Distributed AI processing over Tailscale
Version: 0.2.0
Python: >=3.11 (migrate to 3.12)
Build: ✅ hatchling
Documentation: ✅ README, ✅ Quarto
Features: Web dashboard, 24 parallel workers
Activity: 🟢 Active
Code Size: 30 Python files

ai-chroma

Status: 🟡 Active
Port: 5910 (Service), 5911 (Docs)
Purpose: ChromaDB vector store integration
Version: 0.2.0
Python: >=3.9
Build: ⚠️ setup.py
Documentation: ❌ README (needs creation), ✅ Quarto
Activity: 🟢 Active
Code Size: 29 Python files

info-manager

Status: 🟡 Experimental
Port: 5900 (assigned)
Purpose: Central information and database management
Version: 0.1.0
Python: >=3.9
Build: ⚠️ setuptools
Documentation: ❌ README (needs creation), ❌ Quarto (minimal)
Features: Web interface
Activity: 🟢 Active
Code Size: 15 Python files
Note: Intended as future context registry hub

ai-exo

Status: 🟡 Experimental
Port: Not assigned
Purpose: Run AI cluster at home with everyday devices
Version: 0.3.0
Python: >=3.13 (most modern!)
Build: ⚠️ uv_build (new approach)
Documentation: ✅ README, ❌ Quarto
Features: Web interface
Activity: 🟡 Experimental
Code Size: 106 Python files

Deprecated Projects (4 projects)

ai-mail

Status: 🔴 Deprecated
Port: 5310 (legacy)
Purpose: Mail processing (superseded by ai-korrespondenz)
Version: 0.1.0
Action: Move to deprecated/ folder (conceptually merged)
Documentation: ✅ README, ✅ Quarto
Code Size: 110 Python files
Migration: Use ai-korrespondenz instead

ai-pdai

Status: 🔴 Deprecated
Port: N/A
Purpose: PDAI library (superseded by ai-core/pdai)
Version: 0.1.0
Action: Move to deprecated/ folder
Documentation: ❌ README, ✅ Quarto
Code Size: 10 Python files
Migration: Import from ai_core.pdai instead

ai-eventjournal

Status: 🔴 Inactive
Port: 5500 (assigned)
Purpose: Event journaling (unclear status)
Action: Review and either revive or deprecate
Documentation: ❌ README, ❌ Quarto
Code Size: 0 Python files (empty?)

ai-apple-documents

Status: 🔴 Deprecated
See Apple Ecosystem section above

Experimental/Minimal Projects (5 projects)

ai-task

Status: 🟡 Experimental
Port: Not assigned
Purpose: Task management experiments
Version: 0.3.2
Python: >=3.8
Build: ⚠️ setuptools
Documentation: ❌ README, ✅ Quarto
Activity: 🟡 Active
Code Size: 35 Python files

ai-ocr-dev

Status: 🟡 Development
Purpose: OCR development environment
Documentation: ❌ README, ❌ Quarto
Code Size: Minimal
Note: Development workspace, not a deployable package

ai-schriftsetzer

Status: 🟡 Experimental
Purpose: Typesetting experiments
Version: 1.0.0
Python: >=3.10
Build: ⚠️ setuptools
Documentation: ❌ README, ❌ Quarto
Code Size: 1 Python file

ai-lacie

Status: 🟡 Experimental
Purpose: LaCie drive integration
Version: 0.1.0
Python: >=3.9
Build: ⚠️ setuptools
Documentation: ❌ README, ❌ Quarto
Code Size: 10 Python files

ai-notebook

Status: 🔴 Inactive
Port: 5920 (assigned)
Purpose: Notebook experiments
Documentation: ❌ README, ❌ Quarto
Code Size: 0 Python files (empty?)

Port Assignment Analysis

Assigned Ports (by category)

graph TB
    subgraph core["Core Infrastructure 5000-5099"]
        api[ai-platform-api<br/>5000]
        docs[ai-platform-docs<br/>5050]
    end
    
    subgraph document["Document Processing 5100-5199"]
        viewer[ai-viewer<br/>5100/5101]
        scholar[ai-scholar<br/>5110/5111]
        pdfscholar[ai-pdfscholar<br/>5120]
    end
    
    subgraph voice["Voice & Audio 5200-5299"]
        voicememo[ai-voicememo<br/>5200/5201/5210]
        dictation[ai-dictation<br/>5220]
        audio[ai-audio<br/>5230]
    end
    
    subgraph corresp["Correspondence 5300-5399"]
        korr[ai-korrespondenz<br/>5300/5301]
        mail[ai-mail<br/>5310]
    end
    
    subgraph text["Text Processing 5400-5499"]
        lector[ai-lector<br/>5400/5401]
        translation[ai-translation<br/>5410]
    end
    
    subgraph events["Events & Reporting 5500-5599"]
        eventjournal[ai-eventjournal<br/>5500]
        reporter[ai-reporter<br/>5510/5511]
        agenda[ai-agenda<br/>5520/5521]
    end
    
    subgraph apple["Apple Integration 5600-5699"]
        aiapple[ai-apple<br/>5600/5610/5620]
        applenotes[apple-notes<br/>5630]
    end
    
    subgraph photo["Photography 5700-5799"]
        foto[ai-foto<br/>5700/5701]
        scanner[ai-scanner<br/>5710]
    end
    
    subgraph cluster["Cluster 5800-5899"]
        clusterapi[ai-cluster<br/>5800/5810/5820/5830/5840/5850]
    end
    
    subgraph info["Information 5900-5999"]
        infomgr[info-manager<br/>5900]
        chroma[ai-chroma<br/>5910/5911]
        notebook[ai-notebook<br/>5920]
    end

Port Convention

The ecosystem follows a clear convention:

Service Port: 5x00 (e.g., ai-korrespondenz API on 5300)
Docs Port: 5x01 (e.g., ai-korrespondenz docs on 5301)
Additional Services: 5x10, 5x20, etc.

Unassigned Projects

Projects without port assignments:

ai-ocr - Should get 5130/5131
ai-komparativ-transkription - Has 5051 for docs only
ai-nepi2 - Complex project, may not need network ports
ai-symphony - Should get 5052/5053 if needed
ai-exo - Should get 5860/5861 if production ready
ai-karman-manager - Project-specific, may not need ports
ai-task - Could use 5054/5055

Port Conflicts

No conflicts detected - all assigned ports are unique.

Documentation Status

Documentation Coverage

Category	Projects	With README	With Quarto	Coverage
Core	6	5 (83%)	5 (83%)	Good
Document Processing	4	3 (75%)	3 (75%)	Good
Communication	7	3 (43%)	2 (29%)	Needs Work
Apple Ecosystem	3	1 (33%)	0 (0%)	Poor
Cluster	4	2 (50%)	2 (50%)	Fair
Deprecated	4	1 (25%)	2 (50%)	N/A
Experimental	5	1 (20%)	1 (20%)	Poor
Total	32	16 (50%)	15 (47%)	Fair

Projects Needing README

Priority order:

ai-lector (148 files - large, active, has Quarto)
ai-apple (1504 files - very large, very active)
ai-nepi2 (large, active, complex)
ai-chroma (active, has Quarto)
ai-komparativ-transkription (active, has Quarto)
info-manager (active, strategic)
ai-audio (45 files, active)
ai-dictation (experimental)
ai-task (35 files)

Projects Needing Quarto Documentation

Priority order:

ai-core (foundation package, many dependencies)
apple-notes (active, has README, modern design)
info-manager (strategic hub project)
ai-apple (very large, very active)
ai-audio (active)
ai-symphony (orchestration)
ai-translation (small but useful)
ai-exo (modern, experimental)

Projects with Excellent Documentation

These serve as templates:

ai-voicememo - Complete: README, Quarto, Reports system
ai-korrespondenz - Complete: README, Quarto, comprehensive guides
ai-scholar - Complete: README, Quarto, XML specification
ai-cluster - Complete: README, Quarto, architecture docs

Build System Analysis

Build Backend Distribution

Build Backend	Count	Projects
hatchling ✅	7	ai-korrespondenz, ai-scholar, ai-agenda, ai-foto, ai-cluster, apple-notes
setuptools ⚠️	16	ai-voicememo, ai-viewer, ai-core, ai-reporter, ai-lector, ai-ocr, ai-cluster, ai-apple, ai-dictation, ai-task, ai-symphony, ai-mail, ai-schriftsetzer, ai-lacie, ai-exo, ai-karman-manager
setup.py ⚠️	4	ai-komparativ-transkription, ai-chroma, ai-audio, ai-pdai
uv_build	1	ai-exo
None ❌	4	ai-translation, ai-nepi2, ai-apple-documents, ai-eventjournal, ai-notebook, ai-ocr-dev

Migration Priority

High Priority (Active, Production): 1. ai-voicememo (setuptools → hatchling) 2. ai-viewer (setuptools → hatchling) 3. ai-core (setuptools → hatchling) 4. ai-reporter (setuptools → hatchling)

Medium Priority (Active): 5. ai-lector (setuptools → hatchling) 6. ai-ocr (setuptools → hatchling) 7. ai-apple (setuptools → hatchling) 8. ai-komparativ-transkription (setup.py → pyproject.toml + hatchling) 9. ai-chroma (setup.py → pyproject.toml + hatchling)

Python Version Analysis

Python Version Distribution

Version	Count	Projects
>=3.12 ✅	0	None yet!
>=3.11	3	ai-korrespondenz, ai-agenda, apple-notes
>=3.10	6	ai-voicememo, ai-scholar, ai-reporter, ai-foto, ai-core, ai-schriftsetzer
>=3.9	6	ai-apple, ai-komparativ-transkription, ai-chroma, info-manager, ai-dictation, ai-lacie
>=3.8	6	ai-viewer, ai-ocr, ai-lector, ai-audio, ai-task, ai-symphony, ai-karman-manager
>=3.13	1	ai-exo (most modern!)
Not specified	10	Various experimental/deprecated projects

Migration to Python 3.12

ALL projects should migrate to Python >=3.12 per AI Platform standards.

Priority order: 1. Core packages (6 projects) 2. Active secondary packages (7 projects) 3. Experimental packages (as needed)

Integration Analysis

MCP Server Implementation

Projects with MCP servers:

ai-korrespondenz ✅ - Full MCP server for correspondence access
ai-voicememo ✅ - MCP server for memo classification and retrieval

Candidates for MCP servers:

ai-scholar - Document processing queries
ai-agenda - Project and task queries
ai-viewer - Document viewing
apple-notes - Notes revision access

Web Interfaces

Projects with web dashboards:

ai-voicememo (5200)
ai-korrespondenz (5300)
ai-viewer (5100)
ai-mail (deprecated, 5310)
ai-cluster (5830)
apple-notes (5630)
info-manager (5900)
ai-lector (5400)
ai-exo (experimental)

Shared Library Usage

Projects using ai-platform-shared: - None yet! This is a key integration opportunity

Projects depending on ai-core: - ai-reporter - ai-foto - ai-ocr

Recent Development Activity

Most Active Projects (2026-01-19)

ai-voicememo - Very recent activity, reports system
ai-korrespondenz - Very recent activity, multi-source integration

Active Projects (2026-01-15)

ai-scholar
ai-viewer
ai-agenda
ai-reporter
ai-foto
ai-lector
ai-nepi2
ai-cluster
ai-apple
ai-komparativ-transkription
ai-ocr
ai-translation
apple-notes
info-manager
ai-chroma

Stable/Mature Projects

ai-core (foundation)
ai-symphony (stable)
ai-karman-manager (project complete)

Recommendations

Critical Actions

Create Missing READMEs (Priority order)
- ai-lector (148 files - urgent)
- ai-apple (1504 files - urgent)
- ai-nepi2 (complex - needs overview)
- ai-chroma (active, has Quarto)
- ai-komparativ-transkription (active, has Quarto)
Add Quarto Documentation (Priority order)
- ai-core (foundation package)
- apple-notes (active, well-structured)
- info-manager (strategic)
- ai-apple (very large)
Migrate Build Systems to Hatchling
- Phase 1: Core packages (ai-voicememo, ai-viewer, ai-core, ai-reporter)
- Phase 2: Active packages (ai-lector, ai-ocr, ai-apple)
- Phase 3: Experimental packages (as needed)
Migrate to Python 3.12
- All projects should target >=3.12
- Start with core packages
- Update CI/CD and documentation
Clean Up Deprecated Projects
- Move ai-mail to deprecated/
- Move ai-pdai to deprecated/
- Move ai-apple-documents to deprecated/
- Archive or remove ai-eventjournal and ai-notebook if empty

Integration Opportunities

Adopt ai-platform-shared
- Migrate common models (Person, Project) to shared library
- Use shared database base classes
- Adopt shared MCP patterns
Implement MCP Servers
- ai-scholar (document queries)
- ai-agenda (project/task queries)
- apple-notes (revision access)
Standardize Reports Systems
- Use ai-voicememo reports/ structure as template
- Implement report generation in ai-korrespondenz
- Add reports to ai-scholar for processing metrics

Documentation Improvements

Create Central Documentation Hub
- Enhance .ai-platform/docs site
- Link all project documentation
- Provide architecture overview
Standardize Documentation Structure
- Use ai-voicememo as template
- Include: index, quickstart, CLI, API, guides
- Add reports section where appropriate
Port Assignment Documentation
- Update .ai-platform/docs/ports.qmd
- Assign ports to remaining projects
- Document port convention clearly

Project-Specific Recommendations

ai-nepi2

Urgent: Create root README
Consider: Quarto documentation for overview
Status: Very active, complex, needs visibility

ai-apple

Urgent: Create README (1504 files!)
Consider: Quarto documentation
Consider: Split into smaller, focused packages?
Status: Very large, very active, poorly documented

info-manager

Create README
Add Quarto documentation
Define role as context registry hub
Status: Strategic project for future integration

apple-notes

Add Quarto documentation (has great README)
Consider MCP server for note access
Status: Modern, well-designed, active

ai-lector

Urgent: Create README (148 files!)
Status: Large, active, has Quarto but no README

Migration Roadmap

Phase 1: Foundation (Weeks 1-2)

Migrate core packages to hatchling: ai-voicememo, ai-viewer, ai-core
Update Python requirement to >=3.12 for core packages
Create missing READMEs: ai-lector, ai-apple, ai-nepi2
Move deprecated packages: ai-mail, ai-pdai, ai-apple-documents

Phase 2: Documentation (Weeks 3-4)

Add Quarto docs: ai-core, apple-notes, info-manager
Enhance ai-platform hub documentation
Update port assignments
Create migration guide updates

Phase 3: Standardization (Weeks 5-6)

Migrate remaining active packages to hatchling
Update Python versions across ecosystem
Implement shared library usage
Standardize MCP patterns

Phase 4: Integration (Weeks 7-8)

Add MCP servers where beneficial
Implement reports systems (ai-korrespondenz, ai-scholar)
Create unified documentation hub
Establish continuous integration standards

Conclusion

The 2026project ecosystem is healthy and active with:

6 production-ready core packages
13 active secondary packages
Strong documentation culture (50% with README, 47% with Quarto)
Clear port assignment system
Active development across multiple domains

Key strengths:

Established standards (hatchling, Python 3.12+, google-genai)
Coordination infrastructure (.ai-platform)
Modern tooling (Quarto, MCP servers)
Active development community

Areas for improvement:

Documentation gaps (especially READMEs)
Build system migration (setuptools → hatchling)
Python version updates (all → 3.12)
Shared library adoption
Deprecation cleanup

The ecosystem is well-positioned for continued growth with clear standards and strong foundational packages. The main focus should be on documentation completeness and migration to standardized build systems.

Survey Date: 2026-01-20
Next Review: Q2 2026
Maintainer: AI Platform Coordination Team

--- title: "2026 Projects Ecosystem Survey" subtitle: "Comprehensive Status Report - January 2026" date: "2026-01-20" author: "AI Platform Coordination" format: html: toc: true toc-depth: 4 code-fold: true code-tools: true --- ## Executive Summary This survey documents the complete state of the **2026project** ecosystem as of January 2026, providing a comprehensive overview of all 32 projects, their documentation status, port assignments, and development activity. ### Key Statistics | Metric | Count | |--------|-------| | **Total Projects** | 32 | | **Active Projects** | 19 | | **With Quarto Documentation** | 15 | | **With README** | 16 | | **Deprecated/Legacy** | 4 | | **Experimental** | 9 | | **Port Assignments (5000-5999)** | 28 | ### Health Overview - **🟢 Production Ready**: 6 core packages (ai-korrespondenz, ai-voicememo, ai-scholar, ai-viewer, ai-agenda, ai-core) - **🟡 Active Development**: 13 secondary packages with ongoing work - **🔴 Needs Attention**: 4 projects missing README, 17 without Quarto docs - **⚠️ Migration Required**: 8 projects still using setuptools, 15 projects below Python 3.12 ## Project Categories ### Core Infrastructure (6 projects) These form the foundation of the ecosystem: #### ai-korrespondenz - **Status**: 🟢 Production - **Port**: 5300 (API), 5301 (Docs) - **Purpose**: Unified correspondence management (Gmail, Thunderbird, phone, notes, voice memos) - **Version**: 1.0.0 - **Python**: >=3.11 (migrate to 3.12) - **Build**: ✅ hatchling - **Documentation**: ✅ README, ✅ Quarto - **Features**: MCP server, REST API, multi-source sync, agenda system - **Activity**: 🟢 Recent (2026-01-19) - **Code Size**: 60 Python files #### ai-voicememo - **Status**: 🟢 Production - **Port**: 5200 (Web), 5201 (Docs), 5210 (Legacy API) - **Purpose**: Voice memo sync, classification, transcription with AI - **Version**: 0.1.0 - **Python**: >=3.10 (migrate to 3.12) - **Build**: ⚠️ setuptools (migrate to hatchling) - **Documentation**: ✅ README, ✅ Quarto, ✅ Reports system - **Features**: MCP server, web dashboard, reports generation, classification - **Activity**: 🟢 Recent (2026-01-19) - **Code Size**: 45 Python files - **Note**: Most mature reports system - template for other projects #### ai-scholar - **Status**: 🟢 Production - **Port**: 5110 (Service), 5111 (Docs) - **Purpose**: PDF/OCR processing with AI (Gemini, Ollama) - **Version**: 3.0.0 - **Python**: >=3.10 (migrate to 3.12) - **Build**: ✅ hatchling - **Documentation**: ✅ README, ✅ Quarto - **Features**: Multi-model support, PDAI format, complete pipeline - **Activity**: 🟢 Active (2026-01-15) - **Code Size**: 52 Python files #### ai-viewer - **Status**: 🟢 Production - **Port**: 5100 (Service), 5101 (Docs) - **Purpose**: Universal document viewer for PDAI documents - **Version**: 1.0.0 - **Python**: >=3.8 (migrate to 3.12) - **Build**: ⚠️ setuptools (migrate to hatchling) - **Documentation**: ✅ README, ✅ Quarto - **Features**: Web interface, PDAI format support - **Activity**: 🟢 Active (2026-01-15) - **Code Size**: 9 Python files #### ai-agenda - **Status**: 🟢 Production - **Port**: 5520 (Service), 5521 (Docs) - **Purpose**: Agenda and project management with multi-location support - **Version**: 1.0.0 - **Python**: >=3.11 (migrate to 3.12) - **Build**: ✅ hatchling - **Documentation**: ✅ README, ✅ Quarto - **Features**: Project tracking, location management - **Activity**: 🟢 Active (2026-01-15) - **Code Size**: 25 Python files #### ai-core - **Status**: 🟢 Production - **Port**: N/A (library) - **Purpose**: Shared infrastructure - orchestrator, AI clients, pdai library - **Version**: 1.0.0 - **Python**: >=3.10 (migrate to 3.12) - **Build**: ⚠️ setuptools (migrate to hatchling) - **Documentation**: ✅ README, ❌ Quarto (should add) - **Features**: Gemini/Ollama clients, PDAI document model, orchestrator - **Activity**: 🟢 Active (2026-01-15) - **Code Size**: 25 Python files - **Note**: Foundation package, many projects depend on it ### Document Processing (4 projects) #### ai-ocr - **Status**: 🟡 Active - **Port**: Not assigned - **Purpose**: Multistage PDF OCR processing pipeline - **Version**: 1.0.0 - **Python**: >=3.8 (migrate to 3.12) - **Build**: ⚠️ setuptools - **Documentation**: ✅ README, ✅ Quarto - **Activity**: 🟢 Active - **Code Size**: 18 Python files #### ai-lector - **Status**: 🟡 Active - **Port**: 5400 (Service), 5401 (Docs) - **Purpose**: Text interpretation and editing system - **Version**: 1.0.0 - **Python**: >=3.8 (migrate to 3.12) - **Build**: ⚠️ setuptools - **Documentation**: ❌ README (needs creation), ✅ Quarto - **Features**: Web interface - **Activity**: 🟢 Active - **Code Size**: 148 Python files (large project) #### ai-translation - **Status**: 🟡 Experimental - **Port**: 5410 (assigned but unused) - **Purpose**: Scholarly XML translation (Latin to English) - **Version**: N/A - **Python**: N/A - **Build**: ❌ No package config - **Documentation**: ✅ README, ❌ Quarto - **Activity**: 🟡 Minimal - **Code Size**: 4 Python files #### ai-karman-manager - **Status**: 🟡 Project-specific - **Port**: Not assigned - **Purpose**: Theodor von Karman archive digitization - **Version**: 1.0.0 - **Python**: >=3.8 - **Build**: ⚠️ setuptools - **Documentation**: ✅ README, ❌ Quarto - **Activity**: 🟡 Stable - **Code Size**: 7 Python files ### Communication & Media (7 projects) #### ai-reporter - **Status**: 🟢 Active - **Port**: 5510 (Service), 5511 (Docs) - **Purpose**: Automated audio transcription and publishing - **Version**: 3.5.4 - **Python**: >=3.10 (migrate to 3.12) - **Build**: ⚠️ setuptools - **Documentation**: ✅ README, ✅ Quarto - **Activity**: 🟢 Active - **Code Size**: 35 Python files #### ai-foto - **Status**: 🟢 Active - **Port**: 5700 (Service), 5701 (Docs) - **Purpose**: Semantic photo analysis with 2D segmentation - **Version**: 0.1.0 - **Python**: >=3.10 (migrate to 3.12) - **Build**: ✅ hatchling - **Documentation**: ✅ README, ✅ Quarto - **Activity**: 🟢 Active - **Code Size**: 20 Python files #### ai-nepi2 - **Status**: 🟢 Project-specific (Large) - **Port**: Not assigned (multimedia project) - **Purpose**: Conference presentation processing with video/PDF sync - **Version**: N/A - **Python**: N/A - **Build**: ❌ No package (script collection) - **Documentation**: ❌ No root README, ❌ No Quarto - **Features**: Complex pipeline, multiple subdirs with docs - **Activity**: 🟢 Very Active - **Code Size**: Large (diagnostic/, performance/, function/ subdirs) - **Note**: Needs root README and consideration for Quarto docs #### ai-komparativ-transkription - **Status**: 🟡 Experimental - **Port**: 5051 (Docs) - **Purpose**: Comparative transcription analysis - **Version**: 0.3.0 - **Python**: >=3.9 - **Build**: ⚠️ setup.py (migrate to pyproject.toml + hatchling) - **Documentation**: ❌ README (needs creation), ✅ Quarto - **Activity**: 🟡 Active - **Code Size**: 11 Python files #### ai-audio - **Status**: 🟡 Experimental - **Port**: 5230 (assigned) - **Purpose**: Audio transcription - **Version**: 1.0.0 - **Python**: >=3.8 - **Build**: ⚠️ setup.py - **Documentation**: ❌ README, ❌ Quarto - **Activity**: 🟡 Active - **Code Size**: 45 Python files #### ai-dictation - **Status**: 🟡 Experimental - **Port**: 5220 (assigned) - **Purpose**: QMD dictation experiments - **Version**: 0.1.0 - **Python**: >=3.9 - **Build**: ⚠️ setuptools - **Documentation**: ❌ README, ❌ Quarto - **Activity**: 🟡 Minimal - **Code Size**: 5 Python files #### ai-symphony - **Status**: 🟡 Experimental - **Port**: Not assigned - **Purpose**: AI instruction pipeline orchestration - **Version**: 1.0.0 - **Python**: >=3.8 - **Build**: ⚠️ setuptools - **Documentation**: ✅ README, ❌ Quarto - **Activity**: 🟡 Stable - **Code Size**: 23 Python files ### Apple Ecosystem (3 projects) #### ai-apple - **Status**: 🟡 Active - **Port**: 5600 (Main), 5610 (Catalog), 5620 (Memo) - **Purpose**: Apple ecosystem integration (Notes, Reminders) - **Version**: 0.2.0 - **Python**: >=3.9 - **Build**: ⚠️ setuptools - **Documentation**: ❌ README (needs creation), ❌ Quarto - **Activity**: 🟢 Very Active - **Code Size**: 1504 Python files (very large) - **Note**: Needs documentation urgently given size #### apple-notes - **Status**: 🟢 Active - **Port**: 5630 (assigned) - **Purpose**: AI-powered revision system for Apple Notes - **Version**: 0.1.0 - **Python**: >=3.11 - **Build**: ✅ hatchling - **Documentation**: ✅ README, ❌ Quarto (should add) - **Features**: Web interface, Bauhaus design - **Activity**: 🟢 Active - **Code Size**: 5 Python files #### ai-apple-documents - **Status**: 🔴 Deprecated - **Port**: N/A - **Purpose**: Apple document sources (superseded by ai-korrespondenz) - **Action**: Move to deprecated/ folder - **Documentation**: ❌ README, ❌ Quarto - **Code Size**: 2 Python files ### Cluster & Infrastructure (4 projects) #### ai-cluster - **Status**: 🟢 Active - **Port**: 5800 (API), 5810 (Manager), 5820 (Satellite), 5830 (Dashboard), 5840 (Flower), 5850 (Orchestrator) - **Purpose**: Distributed AI processing over Tailscale - **Version**: 0.2.0 - **Python**: >=3.11 (migrate to 3.12) - **Build**: ✅ hatchling - **Documentation**: ✅ README, ✅ Quarto - **Features**: Web dashboard, 24 parallel workers - **Activity**: 🟢 Active - **Code Size**: 30 Python files #### ai-chroma - **Status**: 🟡 Active - **Port**: 5910 (Service), 5911 (Docs) - **Purpose**: ChromaDB vector store integration - **Version**: 0.2.0 - **Python**: >=3.9 - **Build**: ⚠️ setup.py - **Documentation**: ❌ README (needs creation), ✅ Quarto - **Activity**: 🟢 Active - **Code Size**: 29 Python files #### info-manager - **Status**: 🟡 Experimental - **Port**: 5900 (assigned) - **Purpose**: Central information and database management - **Version**: 0.1.0 - **Python**: >=3.9 - **Build**: ⚠️ setuptools - **Documentation**: ❌ README (needs creation), ❌ Quarto (minimal) - **Features**: Web interface - **Activity**: 🟢 Active - **Code Size**: 15 Python files - **Note**: Intended as future context registry hub #### ai-exo - **Status**: 🟡 Experimental - **Port**: Not assigned - **Purpose**: Run AI cluster at home with everyday devices - **Version**: 0.3.0 - **Python**: >=3.13 (most modern!) - **Build**: ⚠️ uv_build (new approach) - **Documentation**: ✅ README, ❌ Quarto - **Features**: Web interface - **Activity**: 🟡 Experimental - **Code Size**: 106 Python files ### Deprecated Projects (4 projects) #### ai-mail - **Status**: 🔴 Deprecated - **Port**: 5310 (legacy) - **Purpose**: Mail processing (superseded by ai-korrespondenz) - **Version**: 0.1.0 - **Action**: Move to deprecated/ folder (conceptually merged) - **Documentation**: ✅ README, ✅ Quarto - **Code Size**: 110 Python files - **Migration**: Use ai-korrespondenz instead #### ai-pdai - **Status**: 🔴 Deprecated - **Port**: N/A - **Purpose**: PDAI library (superseded by ai-core/pdai) - **Version**: 0.1.0 - **Action**: Move to deprecated/ folder - **Documentation**: ❌ README, ✅ Quarto - **Code Size**: 10 Python files - **Migration**: Import from ai_core.pdai instead #### ai-eventjournal - **Status**: 🔴 Inactive - **Port**: 5500 (assigned) - **Purpose**: Event journaling (unclear status) - **Action**: Review and either revive or deprecate - **Documentation**: ❌ README, ❌ Quarto - **Code Size**: 0 Python files (empty?) #### ai-apple-documents - **Status**: 🔴 Deprecated - See Apple Ecosystem section above ### Experimental/Minimal Projects (5 projects) #### ai-task - **Status**: 🟡 Experimental - **Port**: Not assigned - **Purpose**: Task management experiments - **Version**: 0.3.2 - **Python**: >=3.8 - **Build**: ⚠️ setuptools - **Documentation**: ❌ README, ✅ Quarto - **Activity**: 🟡 Active - **Code Size**: 35 Python files #### ai-ocr-dev - **Status**: 🟡 Development - **Purpose**: OCR development environment - **Documentation**: ❌ README, ❌ Quarto - **Code Size**: Minimal - **Note**: Development workspace, not a deployable package #### ai-schriftsetzer - **Status**: 🟡 Experimental - **Purpose**: Typesetting experiments - **Version**: 1.0.0 - **Python**: >=3.10 - **Build**: ⚠️ setuptools - **Documentation**: ❌ README, ❌ Quarto - **Code Size**: 1 Python file #### ai-lacie - **Status**: 🟡 Experimental - **Purpose**: LaCie drive integration - **Version**: 0.1.0 - **Python**: >=3.9 - **Build**: ⚠️ setuptools - **Documentation**: ❌ README, ❌ Quarto - **Code Size**: 10 Python files #### ai-notebook - **Status**: 🔴 Inactive - **Port**: 5920 (assigned) - **Purpose**: Notebook experiments - **Documentation**: ❌ README, ❌ Quarto - **Code Size**: 0 Python files (empty?) ## Port Assignment Analysis ### Assigned Ports (by category) ```{mermaid} graph TB subgraph core["Core Infrastructure 5000-5099"] api[ai-platform-api 5000] docs[ai-platform-docs 5050] end subgraph document["Document Processing 5100-5199"] viewer[ai-viewer 5100/5101] scholar[ai-scholar 5110/5111] pdfscholar[ai-pdfscholar 5120] end subgraph voice["Voice & Audio 5200-5299"] voicememo[ai-voicememo 5200/5201/5210] dictation[ai-dictation 5220] audio[ai-audio 5230] end subgraph corresp["Correspondence 5300-5399"] korr[ai-korrespondenz 5300/5301] mail[ai-mail 5310] end subgraph text["Text Processing 5400-5499"] lector[ai-lector 5400/5401] translation[ai-translation 5410] end subgraph events["Events & Reporting 5500-5599"] eventjournal[ai-eventjournal 5500] reporter[ai-reporter 5510/5511] agenda[ai-agenda 5520/5521] end subgraph apple["Apple Integration 5600-5699"] aiapple[ai-apple 5600/5610/5620] applenotes[apple-notes 5630] end subgraph photo["Photography 5700-5799"] foto[ai-foto 5700/5701] scanner[ai-scanner 5710] end subgraph cluster["Cluster 5800-5899"] clusterapi[ai-cluster 5800/5810/5820/5830/5840/5850] end subgraph info["Information 5900-5999"] infomgr[info-manager 5900] chroma[ai-chroma 5910/5911] notebook[ai-notebook 5920] end ``` ### Port Convention The ecosystem follows a clear convention: - **Service Port**: `5x00` (e.g., ai-korrespondenz API on 5300) - **Docs Port**: `5x01` (e.g., ai-korrespondenz docs on 5301) - **Additional Services**: `5x10`, `5x20`, etc. ### Unassigned Projects Projects without port assignments: 1. **ai-ocr** - Should get 5130/5131 2. **ai-komparativ-transkription** - Has 5051 for docs only 3. **ai-nepi2** - Complex project, may not need network ports 4. **ai-symphony** - Should get 5052/5053 if needed 5. **ai-exo** - Should get 5860/5861 if production ready 6. **ai-karman-manager** - Project-specific, may not need ports 7. **ai-task** - Could use 5054/5055 ### Port Conflicts No conflicts detected - all assigned ports are unique. ## Documentation Status ### Documentation Coverage | Category | Projects | With README | With Quarto | Coverage | |----------|----------|-------------|-------------|----------| | Core | 6 | 5 (83%) | 5 (83%) | Good | | Document Processing | 4 | 3 (75%) | 3 (75%) | Good | | Communication | 7 | 3 (43%) | 2 (29%) | Needs Work | | Apple Ecosystem | 3 | 1 (33%) | 0 (0%) | Poor | | Cluster | 4 | 2 (50%) | 2 (50%) | Fair | | Deprecated | 4 | 1 (25%) | 2 (50%) | N/A | | Experimental | 5 | 1 (20%) | 1 (20%) | Poor | | **Total** | **32** | **16 (50%)** | **15 (47%)** | **Fair** | ### Projects Needing README Priority order: 1. **ai-lector** (148 files - large, active, has Quarto) 2. **ai-apple** (1504 files - very large, very active) 3. **ai-nepi2** (large, active, complex) 4. **ai-chroma** (active, has Quarto) 5. **ai-komparativ-transkription** (active, has Quarto) 6. **info-manager** (active, strategic) 7. ai-audio (45 files, active) 8. ai-dictation (experimental) 9. ai-task (35 files) ### Projects Needing Quarto Documentation Priority order: 1. **ai-core** (foundation package, many dependencies) 2. **apple-notes** (active, has README, modern design) 3. **info-manager** (strategic hub project) 4. **ai-apple** (very large, very active) 5. ai-audio (active) 6. ai-symphony (orchestration) 7. ai-translation (small but useful) 8. ai-exo (modern, experimental) ### Projects with Excellent Documentation These serve as templates: 1. **ai-voicememo** - Complete: README, Quarto, Reports system 2. **ai-korrespondenz** - Complete: README, Quarto, comprehensive guides 3. **ai-scholar** - Complete: README, Quarto, XML specification 4. **ai-cluster** - Complete: README, Quarto, architecture docs ## Build System Analysis ### Build Backend Distribution | Build Backend | Count | Projects | |---------------|-------|----------| | **hatchling** ✅ | 7 | ai-korrespondenz, ai-scholar, ai-agenda, ai-foto, ai-cluster, apple-notes | | **setuptools** ⚠️ | 16 | ai-voicememo, ai-viewer, ai-core, ai-reporter, ai-lector, ai-ocr, ai-cluster, ai-apple, ai-dictation, ai-task, ai-symphony, ai-mail, ai-schriftsetzer, ai-lacie, ai-exo, ai-karman-manager | | **setup.py** ⚠️ | 4 | ai-komparativ-transkription, ai-chroma, ai-audio, ai-pdai | | **uv_build** | 1 | ai-exo | | **None** ❌ | 4 | ai-translation, ai-nepi2, ai-apple-documents, ai-eventjournal, ai-notebook, ai-ocr-dev | ### Migration Priority **High Priority** (Active, Production): 1. ai-voicememo (setuptools → hatchling) 2. ai-viewer (setuptools → hatchling) 3. ai-core (setuptools → hatchling) 4. ai-reporter (setuptools → hatchling) **Medium Priority** (Active): 5. ai-lector (setuptools → hatchling) 6. ai-ocr (setuptools → hatchling) 7. ai-apple (setuptools → hatchling) 8. ai-komparativ-transkription (setup.py → pyproject.toml + hatchling) 9. ai-chroma (setup.py → pyproject.toml + hatchling) ## Python Version Analysis ### Python Version Distribution | Version | Count | Projects | |---------|-------|----------| | **>=3.12** ✅ | 0 | None yet! | | **>=3.11** | 3 | ai-korrespondenz, ai-agenda, apple-notes | | **>=3.10** | 6 | ai-voicememo, ai-scholar, ai-reporter, ai-foto, ai-core, ai-schriftsetzer | | **>=3.9** | 6 | ai-apple, ai-komparativ-transkription, ai-chroma, info-manager, ai-dictation, ai-lacie | | **>=3.8** | 6 | ai-viewer, ai-ocr, ai-lector, ai-audio, ai-task, ai-symphony, ai-karman-manager | | **>=3.13** | 1 | ai-exo (most modern!) | | **Not specified** | 10 | Various experimental/deprecated projects | ### Migration to Python 3.12 **ALL projects should migrate to Python >=3.12 per AI Platform standards.** Priority order: 1. Core packages (6 projects) 2. Active secondary packages (7 projects) 3. Experimental packages (as needed) ## Integration Analysis ### MCP Server Implementation Projects with MCP servers: 1. **ai-korrespondenz** ✅ - Full MCP server for correspondence access 2. **ai-voicememo** ✅ - MCP server for memo classification and retrieval **Candidates for MCP servers:** - **ai-scholar** - Document processing queries - **ai-agenda** - Project and task queries - **ai-viewer** - Document viewing - **apple-notes** - Notes revision access ### Web Interfaces Projects with web dashboards: 1. ai-voicememo (5200) 2. ai-korrespondenz (5300) 3. ai-viewer (5100) 4. ai-mail (deprecated, 5310) 5. ai-cluster (5830) 6. apple-notes (5630) 7. info-manager (5900) 8. ai-lector (5400) 9. ai-exo (experimental) ### Shared Library Usage Projects using ai-platform-shared: - None yet! This is a key integration opportunity Projects depending on ai-core: - ai-reporter - ai-foto - ai-ocr ## Recent Development Activity ### Most Active Projects (2026-01-19) 1. **ai-voicememo** - Very recent activity, reports system 2. **ai-korrespondenz** - Very recent activity, multi-source integration ### Active Projects (2026-01-15) 3. ai-scholar 4. ai-viewer 5. ai-agenda 6. ai-reporter 7. ai-foto 8. ai-lector 9. ai-nepi2 10. ai-cluster 11. ai-apple 12. ai-komparativ-transkription 13. ai-ocr 14. ai-translation 15. apple-notes 16. info-manager 17. ai-chroma ### Stable/Mature Projects - ai-core (foundation) - ai-symphony (stable) - ai-karman-manager (project complete) ## Recommendations ### Critical Actions 1. **Create Missing READMEs** (Priority order) - ai-lector (148 files - urgent) - ai-apple (1504 files - urgent) - ai-nepi2 (complex - needs overview) - ai-chroma (active, has Quarto) - ai-komparativ-transkription (active, has Quarto) 2. **Add Quarto Documentation** (Priority order) - ai-core (foundation package) - apple-notes (active, well-structured) - info-manager (strategic) - ai-apple (very large) 3. **Migrate Build Systems to Hatchling** - Phase 1: Core packages (ai-voicememo, ai-viewer, ai-core, ai-reporter) - Phase 2: Active packages (ai-lector, ai-ocr, ai-apple) - Phase 3: Experimental packages (as needed) 4. **Migrate to Python 3.12** - All projects should target >=3.12 - Start with core packages - Update CI/CD and documentation 5. **Clean Up Deprecated Projects** - Move ai-mail to deprecated/ - Move ai-pdai to deprecated/ - Move ai-apple-documents to deprecated/ - Archive or remove ai-eventjournal and ai-notebook if empty ### Integration Opportunities 1. **Adopt ai-platform-shared** - Migrate common models (Person, Project) to shared library - Use shared database base classes - Adopt shared MCP patterns 2. **Implement MCP Servers** - ai-scholar (document queries) - ai-agenda (project/task queries) - apple-notes (revision access) 3. **Standardize Reports Systems** - Use ai-voicememo reports/ structure as template - Implement report generation in ai-korrespondenz - Add reports to ai-scholar for processing metrics ### Documentation Improvements 1. **Create Central Documentation Hub** - Enhance .ai-platform/docs site - Link all project documentation - Provide architecture overview 2. **Standardize Documentation Structure** - Use ai-voicememo as template - Include: index, quickstart, CLI, API, guides - Add reports section where appropriate 3. **Port Assignment Documentation** - Update .ai-platform/docs/ports.qmd - Assign ports to remaining projects - Document port convention clearly ### Project-Specific Recommendations #### ai-nepi2 - **Urgent**: Create root README - Consider: Quarto documentation for overview - Status: Very active, complex, needs visibility #### ai-apple - **Urgent**: Create README (1504 files!) - Consider: Quarto documentation - Consider: Split into smaller, focused packages? - Status: Very large, very active, poorly documented #### info-manager - Create README - Add Quarto documentation - Define role as context registry hub - Status: Strategic project for future integration #### apple-notes - Add Quarto documentation (has great README) - Consider MCP server for note access - Status: Modern, well-designed, active #### ai-lector - **Urgent**: Create README (148 files!) - Status: Large, active, has Quarto but no README ## Migration Roadmap ### Phase 1: Foundation (Weeks 1-2) 1. Migrate core packages to hatchling: ai-voicememo, ai-viewer, ai-core 2. Update Python requirement to >=3.12 for core packages 3. Create missing READMEs: ai-lector, ai-apple, ai-nepi2 4. Move deprecated packages: ai-mail, ai-pdai, ai-apple-documents ### Phase 2: Documentation (Weeks 3-4) 1. Add Quarto docs: ai-core, apple-notes, info-manager 2. Enhance ai-platform hub documentation 3. Update port assignments 4. Create migration guide updates ### Phase 3: Standardization (Weeks 5-6) 1. Migrate remaining active packages to hatchling 2. Update Python versions across ecosystem 3. Implement shared library usage 4. Standardize MCP patterns ### Phase 4: Integration (Weeks 7-8) 1. Add MCP servers where beneficial 2. Implement reports systems (ai-korrespondenz, ai-scholar) 3. Create unified documentation hub 4. Establish continuous integration standards ## Conclusion The 2026project ecosystem is **healthy and active** with: - 6 production-ready core packages - 13 active secondary packages - Strong documentation culture (50% with README, 47% with Quarto) - Clear port assignment system - Active development across multiple domains **Key strengths:** - Established standards (hatchling, Python 3.12+, google-genai) - Coordination infrastructure (.ai-platform) - Modern tooling (Quarto, MCP servers) - Active development community **Areas for improvement:** - Documentation gaps (especially READMEs) - Build system migration (setuptools → hatchling) - Python version updates (all → 3.12) - Shared library adoption - Deprecation cleanup The ecosystem is well-positioned for continued growth with clear standards and strong foundational packages. The main focus should be on documentation completeness and migration to standardized build systems. --- **Survey Date**: 2026-01-20 **Next Review**: Q2 2026 **Maintainer**: AI Platform Coordination Team