What is Heliotrope and what does it schedule?

A carbon-aware load scheduler: you describe deferrable loads such as EV charging, water heating, laundry and cooling with deadlines, and it places them in the lowest-carbon grid windows while guaranteeing every deadline, energy need, thermal band and shared capacity limit.

How does Jev take part?

Jev (TypeSafe AI's System One model) classifies loads with calibrated confidence and judges how essential each appliance is for the 'which load first?' ranking at /loads/prioritize, while time pressure, size and rigidity stay in code.

Is a Jev key required?

No — without a key, a labelled built-in heuristic answers the same intake and ranking questions. With a key, Jev classifies with calibrated confidence and flags ambiguity, per the README's features list.

How does it decide the schedule?

Three solvers: ASAP as a carbon-blind baseline, a cheapest-first greedy heuristic, and an exact OR-Tools CP-SAT formulation with integer-scaled arithmetic, overflow guards and an independent post-solve validator; INFEASIBLE is an explicit 200 response.

What happens when the carbon forecast changes?

Forecasts may change which schedule is preferred, never whether one is feasible: deadlines and physics are hard constraints, and carbon is only the objective, so a shifted signal cannot push a load past its deadline.

What stack does it use?

Next.js with Tailwind on the front end and FastAPI on the back end, with OR-Tools for scheduling and live weather-based carbon signal data from Open-Meteo, per the repository description; Firestore appears among the topics.

Who built it and what licence is it under?

StellarieX built it. Metadata: Python, MIT, 5 stars, 5 forks, created 2026-10-02 and pushed 2026-10-14. Topics include carbon-aware, cp-sat, demand-response, energy-scheduling, open-meteo and sustainability.

Jev directory

CommunityJev Tools & CLIs

Heliotrope

A carbon-aware load scheduler that shifts deferrable electricity loads — EV charging, water heating, laundry, cooling — into the cleanest grid hours without missing a deadline. Jev classifies loads and ranks which matters first; OR-Tools CP-SAT keeps deadlines and physics hard while carbon is the objective.

See highlights Open github.com

Stars: 5
Language: Python
License: MIT
Reading time: 2 min
Published by: Community
Author: stellariex
Last verified: Oct 2026

stellariex/heliotrope

Organization repository on GitHub

View on GitHub

Carbon-aware load scheduler: shifts EV charging, water heating, laundry and pumps into the cleanest grid hours without missing a deadline. Next.js + FastAPI + OR-Tools CP-SAT, live weather-based carbon signal, System One decisions, execution tracking.

Forks: 5
Last pushed: Updated Oct 2026

Repo stats from the GitHub API, cached Oct 2026.

Tagscommunity github python sustainability scheduling

Works forJev for Classification Jev for Ranking Jev for Realtime control

Used inJev for Software & DevTools

Languages: Python TypeScript
Platforms: Next.js
Capabilities: Open sourceSelf-hosted

Highlights

Jev classifies loads with calibrated confidence and judges how essential each appliance is for the which-load-first ranking.
Without a Jev key, a labelled built-in heuristic answers.
/loads/classify turns plain words like 'geyser at night' into a typed LoadSpec: FIXED, ATOMIC, INTERRUPTIBLE or THERMAL.
Three solvers: ASAP baseline, greedy, and exact OR-Tools CP-SAT with integer-scaled arithmetic and a post-solve validator.
Deadlines and physics are hard constraints; carbon is the objective; forecasts never change feasibility.

Watch out

README reviewed 2026-10-17; the digest truncates the features list mid-sentence, so the interface, data sources and deployment details could not be read. No accuracy comparison between the Jev path and the heuristic is reported, and the Jev route needs a TypeSafe key.

Questions about this entry

Short answers drawn from the linked project or page.

From the Jev guides

Original write-ups on what this entry is for.

Jev at home: voice pipelines, Assist routing, and sentinels

Oct 16, 2026

How Home Assistant conversation agents, macOS voice pipelines, and an advisory sentinel put a fast typed decision in the loop — one call per utterance, thresholds in code, and a daily token budget.

Jev Tools & CLIs#home-assistant#voice#automation

Read article

Search visibility, audited by decisions

Oct 16, 2026

Jev-based SEO tools split the crawl from the call: deterministic crawlers count and parse, while typed judgments rank fixes, place internal links, score search results, and track AI-answer mentions — with costs and caveats attached.

Jev Tools & CLIs#seo#search-visibility#audits

Read article

Jev on the Gateways: Vercel, Workers AI, and OpenRouter

Oct 12, 2026

The request shape barely changes across surfaces; the surrounding contract does. When to call the API directly and when a gateway, a Worker binding, or a router entry earns its extra hop.

Jev Tools & CLIs#gateway#vercel#cloudflare

Read article

From the Jev AI model community

Posts from builders shipping with Jev right now.

Follow @typesafeai

Heliotrope

Highlights

Questions about this entry

What is Heliotrope and what does it schedule?

How does Jev take part?

Is a Jev key required?

How does it decide the schedule?

What happens when the carbon forecast changes?

What stack does it use?

Who built it and what licence is it under?

More Jev resources like this

From the Jev guides

From the Jev AI model community