komAI/AGENTS.md

komAI Agent Guidelines

Entry Point

python -m app.komAI

Architecture

• app/ - application entry point (komAI.py expected)
• src/ - source code, src/__init__.py exposes centralized API
• config/ - YAML configuration; config/global.yaml is the main config
• modules/ - pluggable modules, configured via global.modules
• log/ - runtime logs
• tests/ - standalone unit tests (executable from CLI)

Config System

• Modules register parameters at initialization
• Save config: from src import save_config; save_config()

Logging

• All console output is duplicated to log files
• Log config in config/global.yaml (level, file, path)

Env Vars (see .env.example)

• KOMAI_CONFIG - path to config file (optional)
• LOGGING_LOG_PATH, LOGGING_LOG_FILE, LOGGING_LEVEL

Requirements

• Python >3.10

No Code Yet

This repo is a scaffold. No .py source files exist yet. Do not assume any modules, classes, or APIs are implemented.