Elastisched

Elastisched is an elastic scheduling system for time-constrained tasks and recurring events. It combines deterministic constraints with a C++ optimization engine, an API-first backend, and an interactive calendar UI.

Highlights

• Flexible "blob"-based event model with schedulable windows and policy flags.
• Simulated-annealing scheduler with configurable cost weights and granularity.
• Recurrence system (single, multiple, weekly, delta, date).
• FastAPI backend for local scheduling, recurrence, and analytics workflows.
• Vanilla JS frontend with day/week/month/year views and scheduling controls.

Architecture

• backend/: FastAPI app, persistence, and scheduling routes.
• core/: Python scheduling domain primitives (blob, timerange, recurrence).
• engine/: C++ scheduler + pybind11 Python bindings.
• frontend/: Browser UI served at /ui.
• learning/: Preference-learning and embedding scaffolding.

Repository Docs

• backend/README.md
• core/README.md
• docs/README.md
• engine/README.md
• frontend/README.md
• landing/README.md
• learning/README.md
• tests/README.md
• bin/README.md

Quick Start

Docker

1. cp .env.example .env
2. docker compose --env-file .env up --build
3. Open http://localhost:8080 (recommended) or http://localhost:8000/ui.

Local Development

1. python3 -m venv .venv
2. source .venv/bin/activate
3. pip install -r requirements.txt
4. uvicorn backend.main:app --reload --host 0.0.0.0 --port 8000
5. Open http://localhost:8000/ui

Configuration

Common environment variables:

• DATABASE_URL (default: sqlite+aiosqlite:///./core.db)
• ELASTISCHED_PROJECT_TZ (default: UTC)

Use .env.example as the template for local setup.

Testing

• Python tests: pytest -q
• C++ engine tests:
  1. cmake -S engine -B engine/build_tests -DELASTISCHED_BUILD_TESTS=ON
  2. cmake --build engine/build_tests
  3. ctest --test-dir engine/build_tests --output-on-failure

License

MIT. See LICENSE.