Platforma

Platforma is an AI-assisted task execution platform. The repository is organized into clear top-level areas:

• platform/backend/ — FastAPI backend, orchestration, LLM integration, agents, persistence, tests.
• platform/frontend/ — static web / Telegram Mini App frontend.
• demos/todo-api/ — standalone Todo API demo application.
• templates/ — project templates used by the platform.
• docs/ — architecture, API, environment, and Telegram setup documentation.
• scripts/ — root helper scripts.

Backend

cd platform/backend
pip install -r requirements.txt
ruff check .
pytest -q

Frontend

Frontend assets live in platform/frontend/ and can be served by the backend or the frontend Docker image.

Demo

The Todo API demo is isolated under demos/todo-api/ so it no longer conflicts with platform backend modules.