Temporaeth

provenance:github:smouj/Temporaeth

WHAT THIS AGENT DOES

Temporaeth is a predictive planning engine designed to intelligently schedule tasks and events. It transforms constraints into adaptive plans, proactively resolving conflicts and optimizing agendas. Individuals and teams struggling with complex scheduling challenges, conflicting priorities, and time limitations would find it beneficial. Temporaeth's core strength lies in its ability to predict potential issues and adjust plans accordingly. It offers a streamlined approach to calendar management, task prioritization, and deep-work scheduling. The agent is designed to be easily self-hosted and integrates with various tools. Ultimately, Temporaeth aims to automate and optimize the planning process, freeing users from manual effort and improving overall productivity.

PROBLEM IT SOLVES

Temporaeth solves the problem of manual planning, which often fails when dealing with conflicting priorities and tight time constraints. Users would choose Temporaeth over manual methods because it provides an automated, predictive, and adaptive solution that proactively resolves conflicts and optimizes schedules.

View Source ↗First seen 3mo agoNot yet hireable

CAPABILITIES & CONSTRAINTS

TECH & STACK

pythonfastapischedulingplanningaicalendartask-management

README

# Temporaeth

<p align="center">
  <img src="./assets/branding/logo.svg" alt="Temporaeth logo" width="88" />
</p>

![Language](https://img.shields.io/badge/language-Python%203.11%2B-blue)
![License](https://img.shields.io/github/license/smouj/Temporaeth)
![Last Commit](https://img.shields.io/github/last-commit/smouj/Temporaeth)
![CI](https://img.shields.io/github/actions/workflow/status/smouj/Temporaeth/ci.yml?branch=main)
[![Ko-fi](https://img.shields.io/badge/Ko--fi-Support%20this%20project-ff5f5f?logo=ko-fi&logoColor=white)](https://ko-fi.com/smouj013_dev)

<p align="center">
  <a href="./README.md"><img src="https://img.shields.io/badge/README-English-1f6feb?style=for-the-badge" alt="English"></a>
  <a href="./README.es.md"><img src="https://img.shields.io/badge/README-Español-c92a2a?style=for-the-badge" alt="Español"></a>
</p>

**Predictive planning engine for intelligent scheduling.**

## Vision
Transforms constraints into adaptive plans with conflict-aware scheduling logic.

## What problem it solves
Manual planning fails under conflicting priorities and time constraints.

## Core superpower
- ⚡ **Constraint-aware agenda optimization with predictive prioritization**

## Key use cases
- ✅ Calendar planning
- ✅ Task prioritization
- ✅ Conflict resolution
- ✅ Deep-work scheduling


## API surface
`POST /plan`, `GET /caldav`, `GET /health`

## Technical stack
- **Core stack:** FastAPI + planning heuristics + temporal models
- **Runtime:** local-first, self-hosted friendly
- **Infra:** Docker Compose + Caddy + Redis/Chroma/Ollama compatibility

## Current status (Feb 2026)
- ✅ Public scaffold available
- ✅ Bilingual README (EN default + ES)
- ✅ CI + release baseline configured
- 🚧 Feature hardening in progress

## Quick start
```bash
git clone https://github.com/smouj/Temporaeth.git
cd Temporaeth
python -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
python -m src.temporaeth.cli --help
```

## Documentation
- [Implementation Guide](./docs/IMPLEMENTATION.md)
- [Architecture](./docs/ARCHITECTURE.md)
- [Runbook](./docs/RUNBOOK.md)
- [Deployment Guide](./docs/DEPLOYMENT.md)
- [Release Process](./docs/RELEASE.md)
- [Changelog](./CHANGELOG.md)

## Contributing
Contributions are welcome. Please read [CONTRIBUTING.md](./CONTRIBUTING.md).

## License
MIT © 2026 smouj

---

### Other skills
Explore the full ecosystem here: **[smouj/smouj](https://github.com/smouj/smouj)**

**Signature:** [@Smouj013](https://x.com/smouj013)

PUBLIC HISTORY

First discoveredMar 21, 2026

IDENTITY

inferred

Identity inferred from code signals. No PROVENANCE.yml found.

Is this yours? Claim it →

METADATA

platformgithub

first seenFeb 23, 2026

last updatedFeb 24, 2026

last crawled2 months ago

version—

README BADGE

Add to your README:

![Provenance](https://getprovenance.dev/api/badge?id=provenance:github:smouj/Temporaeth)