What FTW asked for
Keep the target and the command result visible. Core checks each command against the current site and equipment limits.
Current beta · Your hardware · Sourceful maintained
-Make supported solar, batteries and car charging from different brands work together. FTW plans ahead, controls locally and shows what the equipment actually does.
+FTW · Public beta
+A fast, local core for your home's energy. FTW brings solar, batteries and car charging together. Use it from your iPhone, the web, Home Assistant or an AI assistant.
-
- Energyplan
-When should the battery charge? What energy does the car need before departure? Energyplan weighs these needs together with electricity prices, tariffs, solar and household forecasts, battery state and efficiency.
-Energyplan runs as a compiled local worker. It proposes a plan; FTW Core checks every proposal and keeps its own fallback. The worker never sends commands to hardware.
- How planning and Core work together -
- Are we in control?
-A command reply does not prove that power changed. The current beta shows whether a controlled device follows FTW, is waiting, is limited or needs attention.
-Keep the target and the command result visible. Core checks each command against the current site and equipment limits.
Fresh readings show whether the device follows. Old or missing readings stay distinct from a measured response.
When independent measurements support it, Core confirms the physical change. The available proof depends on the device and its readings.
Core keeps safety and control on the box. Stale required site-meter data stops dispatch; an unavailable planner leaves Core's local fallback.
- What changed in the beta +Have an iPhone? Join the iOS beta on TestFlight
+
+ 
+ Real app screens · Simulated homes
+Your equipment
-Check your model, firmware and the functions that have been verified. A catalog entry alone does not prove that FTW can control a device.
+01 / The energy core
+Your meter, solar, battery and charger each report their own readings. FTW reads them together, plans ahead and controls on the equipment's own network. The core runs on your hardware and keeps working when an app or assistant disconnects.
Lua drivers connect supported meters, inverters and batteries. Each device keeps its own limits and capabilities.
Check the device catalogActive control needs a working site meter and a confirmed main fuse rating. FTW checks those limits against current measurements.
Prepare your setupUse charging goals and Charge now. OCPP 1.6J and 2.0.1 chargers connect to FTW's built-in server without a Lua driver. Verify the functions your charger supports.
OCPP charger setupLive power, stored energy and device health. Fresh readings, estimates and missing data stay distinct.
Energyplan combines prices, solar, household forecasts and charging needs into one local plan.
Core checks commands against site and equipment limits, then checks the readings for the response.
Get running
-2.x and 3.x will receive no further updates. Switch to the new 0.x line for current fixes and features. Do not install 3.x beta.
-Old FTW on a Raspberry Pi? Use a second SD card. Keep the old card. Prepare the new one and swap cards before running install commands. Guided transfer of old settings and history is not ready.
-Choose one path below. A refused native install is a stop point; do not try Docker next. Same-host Docker needs a planned switch with old Core stopped and MQTT preserved.
-Apps and access
-Use the web app on a phone or computer. Keep control at home and choose whether a readable copy of your home's data leaves the box.
-Open the local web app at home or pair the installable web client for remote access. The relay carries encrypted traffic and cannot read your home's data. Try the public demo with simulated equipment.
Try the web appThe latest beta adds FTW Cloud support. When the owner turns it on, the box sends a signed, readable copy for phone access and alerts. Cloud reads that data and never controls equipment. This differs from the blind relay; local operation remains the default.
Read the Cloud designSeparate iPhone and Android apps use the same pairing and encrypted protocol. They are still in development. Store releases and the web app's full set of features are not available yet.
Follow native app developmentArchitecture
-FTW Core owns measurements, state, safety and device commands. Energyplan supplies forecasts and proposed plans through a defined contract. Both run on your own host. The implementation uses Go, Lua drivers and compiled Energyplan workers.
-Signals in
-
Coordinated out
-Site convention Above the driver boundary, positive power means energy flowing into the site. Every device speaks the same language.
- Read the architecture -Daily use
-Use Home Assistant through MQTT, the local API or the Modbus TCP proxy. When an external system takes write ownership of a configured endpoint, FTW stops sending competing commands there.
-Open drivers connect supported equipment. MQTT discovery connects Home Assistant. Local APIs and the Modbus proxy give other systems a defined way to read and control.
Read the integration guidesNative installations can check for a new beta, show download progress and confirm the running version after restart. The update checks installation readiness and stored-data compatibility before it proceeds.
How updates workChoose how the household uses solar and stored energy, set a charging goal and departure time, and inspect the plan. The beta shows planning errors and warns when saved charging steps exceed the charger's limit.
Explore the demo planBuild with it
-FTW drivers are plain Lua files with capability-scoped access to Modbus, MQTT, HTTP, WebSocket and TCP. Edit a driver on the Pi and reload it without rebuilding the Go runtime.
-02 / An energy primitive for AI
+Ask why the battery is charging. Understand tonight's plan. Get help connecting your equipment. FTW gives an authorized assistant the context to answer.
+The FTW plugin brings that access to ChatGPT. MCP gives agents a structured way to work with the core. You choose who gets access and can revoke it. Core checks every request and keeps control at home.
+ Explore FTW for ChatGPT +ChatGPT plugin preview · Public directory listing pending
+A FEW THINGS TO ASK
+function driver_init(config)
- host.set_make("My Inverter")
- host.mqtt_subscribe(config.topic)
-end
-
-function driver_poll()
- local watts = read_power()
- host.emit("battery", {
- power_w = watts,
- soc = read_soc()
- })
- return 1000
-endState, history, goals and plans through APIs and MCP. Connect your own agent or automation, with scoped access and Core's validation.
Agent-led setup and accessThe community edition
-Run FTW at home, study it and modify it. FTW's open-source code uses AGPLv3 with a narrow Energyplan exception. Share covered source when the license requires it. The proprietary Energyplan worker permits unmodified use with FTW only for your own private household. Free, noncommercial redistribution with FTW is allowed only for that household use, with its license and notices. Other use or distribution, including commercial use and operation for others, requires a separate written Sourceful license. Sourceful Energy develops and maintains FTW. Contributions are welcome: start with an issue, share a short Markdown proposal or send a focused PR with relevant test evidence.
- -FTW Community comes without official support, warranty, response times or service-level commitments. Help is best-effort from other users and maintainers.
- -Report a need, share a Markdown proposal or send a tested fix. Prefer an issue as the starting point. Our agentic-first approach uses clear problems and reproducible results that people and agents can review. Hardware claims need hardware evidence.
- -03 / Built to feel immediate
+The apps show saved readings straight away, then catch up with the box. Every reading keeps its age. Watch the flow, change a charging goal and see what FTW does next.
FTW FOR iPHONE · iOS 26+
Live energy, car charging and electricity prices. Check the plan, set a charging goal or choose Charge now. Keep prices close with widgets.
Get the iOS beta on TestFlightIncludes a simulated home to explore before you connect a box.
FTW WEBAPP · PHONE + COMPUTER
Live flow, plans, history and access to your box. Install the webapp on your home screen and open it like an app. Pair it with FTW to use your own home's data.
Open the webapp and try the demoThe public demo uses simulated equipment. No box needed.
04 / Planning that stays local
For organizations
-AGPLv3 permits commercial use of the covered FTW code under its source-sharing terms. Commercial Energyplan use, OEM bundles and paid services involving the worker require a separate Sourceful license. Sourceful also offers deployment, maintenance and support.
- Talk to Sourceful -Supported deploymentsArchitecture, commissioning, upgrades and operational handover.
Integrations + OEMCustom hardware, certification, white-label and product delivery.
Fleet operationsProvisioning, observability and managed multi-site boundaries.
Long-term supportDefined maintenance, security handling, response times and SLA.
Prices change. The car plugs in. The forecast changes. FTW updates the plan around your goals and the energy available.
+Energyplan runs locally. Core checks each proposed plan before it reaches a device. Site limits and fresh meter readings govern control.
+ Check your equipment in the device catalogFTW Connect · In development
Sourceful is developing remote help and system maintenance for FTW households: understand system health, investigate faults and manage approved updates. Connect has no running service or public subscription yet. Pricing, support and maintenance scope remain open.
Follow Sourceful services05 / Try the beta
Explore a demo, run FTW inside Home Assistant or install it on your own Linux host. Then connect the apps and assistants you want to use.
Already running FTW? Follow the switch or update guide. The retired 2.x and 3.x lines receive no more updates.
Keep a full backup and your old data. On a Raspberry Pi, keep the old SD card and use a second card. Guided transfer of old settings and history is not ready. Stop old Core and its autostart before another Core controls the same equipment. If an install refuses the old layout, follow the guide before trying another path.
FTW Community
-Run it. Explore it. Tell us what would make it better.
-Open code · Sourceful maintained
FTW is open-source software. Connect your own software, adapt Lua drivers and contribute a tested fix. Sourceful develops and maintains the project with the community.
FTW code uses AGPLv3 with the Energyplan permission. The separate Energyplan worker is licensed for private household use. Commercial worker use needs a Sourceful license. Licensing · Community and commercial support