ranciliopid: open-source PID for Rancilio Silvia

What is ranciliopid and is it the same as CleverCoffee?

Short answer: ranciliopid is an open-source PID controller for the Rancilio Silvia, built on an ESP32. In 2024 the project was renamed CleverCoffee and moved to the rancilio-pid GitHub org. Firmware v4.0.0 dropped ESP8266 support. Same project, new name, one platform.

I have watched this project for years. The original btotherunner/ranciliopid repo ran on a NodeMCU, which is an ESP8266 breakout. It worked. People modded hundreds of Silvias with it. Then the maintainers consolidated under the rancilio-pid org, renamed the firmware CleverCoffee, and shifted all active development to the ESP32. The old btotherunner repo now just redirects you to the new home. If you find a 2019-era forum thread referencing ranciliopid on a NodeMCU, that history is real. It is not the path you should start today.

What the mod actually does: it replaces the Silvia's stock bang-bang thermostat with a PID loop holding the boiler to roughly 0.1 degrees Celsius. On top of that it layers shot timing, brew by weight, brew by time, a separate steam-mode PID with its own constants, MQTT for Home Assistant, BLE scale support for Acaia and similar, OTA firmware updates, and a browser-based config UI. The 3-way solenoid valve can be driven for pre-infusion. Auto-tune and feedforward compensation ship in the firmware. This is not a forty-dollar Auber PID with a single setpoint. It is a small networked computer bolted to your espresso machine.

Key takeaway: ranciliopid and CleverCoffee are the same project. ESP32 is the only supported platform. The NodeMCU line is legacy, kept alive only for existing installs.

Is the ranciliopid mod safe to attempt from a web guide alone?

Short answer: No. The Silvia's boiler heater and 3-way solenoid both run on mains voltage, 115V or 230V depending on market. This page is a planning layer, not an install walkthrough. The handbook does the install. Both are L3 work.

I am going to be blunt with you. Mains voltage kills a few people a year in their own kitchens, and it does not care how good your intentions are. The ranciliopid build taps into the heater circuit, the brew switch circuit, and optionally the 3-way solenoid circuit. Two of those three carry mains. The boiler is a sealed pressure vessel with a heating element that can run away if your PID misbehaves or your temperature sensor comes loose. This is not a USB project. It is L3 work, which means: do not attempt alone, do not attempt tired, do not attempt without a meter and someone who has wired mains before.

This page helps you pick a board, pick a feature set, and pick a parts list. It does not tell you which wire to solder to which pad on your specific Silvia. That lives in the official handbook at manual.rancilio-pid.de, which assumes you bring a baseline of electrical competence. I read the official docs on 2026-07-20 to write this page. If the firmware has moved on, defer to the handbook, not to me. What follows is the decision tree: which Silvia you have, which board to buy, which features to enable, and where the build tends to go sideways.

Key takeaway: Treat ranciliopid as an L3 mains-voltage project. Plan here, install from the official handbook, and do not solo it if you have never wired mains before.

Which Rancilio Silvia versions work with ranciliopid?

Short answer: Every Silvia from V1 through V6 is a candidate. The mod taps the heater circuit, the brew switch, and optionally the 3-way solenoid. The real variable is your market voltage and your specific wiring diagram, not the version badge.

The Rancilio Silvia has been in production since 2001, and the version numbering runs V1 through V6. Mechanically and thermally the machine has barely changed across two decades. The boiler is the same basic steel vessel with a heating element. The brew switch is still a physical toggle. The 3-way solenoid is still there on every version. What shifts between versions is cosmetic trim, badge styling, the steam knob, and some internal wire routing. None of those changes break compatibility. The heater circuit is the heater circuit.

What does matter is your market. Silvias ship in two flavors: 230V for Europe and most of Asia, and 115V for North America. The SSR, the PSU sizing, and your wire gauge all change with that voltage. A build designed for 230V will not gracefully translate to 115V, and vice versa. Confirm your machine's wiring colors against the handbook's diagram for your version, because Rancilio has quietly changed wire colors between production runs. Do not trust a forum photo. Trust the nameplate and the matching wiring diagram.

Key takeaway: Version compatibility is universal across V1 through V6. Market voltage and your wiring diagram are the real checkpoints. Photograph your nameplate before ordering.

How do I match my Silvia to the right PID hardware path?

Short answer: Compatibility is universal across V1 through V6. Every Silvia ships with a 3-way solenoid, so every version supports pre-infusion. The variables that change your build are market voltage, pre-infusion yes or no, and PCB choice.

Key takeaway: Pick your version, confirm your voltage, and decide on pre-infusion up front. Those three answers determine your entire BOM.

NodeMCU vs ESP32: which ranciliopid platform should I run?

Short answer: Run an ESP32. The NodeMCU line is legacy, kept on life support for existing installs. The cron1c/ranciliopid32 fork was an early ESP32 port from 2019 that used Blynk and never moved to v4.0.0. The current CleverCoffee firmware is the only one worth starting today.

The NodeMCU costs three dollars less. That is the only argument for it, and it is a bad one. You give up the web flasher, BLE scale support, the JSON config system, and you paint yourself into a firmware branch that no longer gets features. The ESP32 DevKitC v4 is the board the official CleverCoffee PCB is designed around. The pin mapping matches. The handbook assumes it. Save the three dollars somewhere else.

Key takeaway: ESP32 DevKitC v4 is the only sane starting point. NodeMCU and the cron1c fork are history lessons, not build targets.

What does ranciliopid do that a stock Silvia cannot?

Short answer: It turns the Silvia into a networked, scriptable espresso machine. Temperature holds to 0.1 degrees. Shots run by weight or by time. Steam has its own PID. A BLE scale auto-tares on brew start.

A stock Silvia ships with a bimetallic thermostat that swings plus or minus five degrees Celsius. That is why your first shot is sour and your third is bitter on the same machine. The ranciliopid PID loop tightens that swing to 0.1 degrees. That alone changes the machine. But the firmware does not stop at temperature. Shot timer, brew by weight via a load cell or a BLE scale, brew by time, a separate steam-mode PID with its own constants, automatic backflush, standby timer, and MQTT for Home Assistant.

The brew switch can be read through an optocoupler for minimally invasive install, meaning you do not cut the original wiring. You tap it. The display is a 128x64 OLED with multiple templates, including vertical layouts, and you can write your own. Firmware updates push over WiFi. Configuration is a JSON file you can download, edit, and re-upload through the embedded web page. No compile, no PlatformIO, no Git. The web flasher at rancilio-pid.github.io/clevercoffee-flasher means a new user can install the firmware from a Chromium browser with no toolchain.

Key takeaway: ranciliopid gives the Silvia commercial-grade temperature stability, weight-based dosing, Home Assistant integration, and OTA firmware. The stock thermostat cannot do that.

Is auto-tune, feedforward, and pre-infusion worth the wiring?

Short answer: Auto-tune and feedforward are pure firmware wins. Enable both on every build. Pre-infusion is a hardware project on top of a hardware project. Do it on your second build, not your first.

Auto-tune is the PID teaching itself its own constants. You run it once on a cold machine, the firmware watches the thermal response, and it writes Kp, Tn, and Tv values tuned to your specific boiler and your specific room temperature. Manual PID tuning is a dark art. Auto-tune removes most of the guesswork. There is no wiring cost. It is a menu option. Turn it on.

Feedforward compensation is the firmware anticipating the temperature drop that happens the moment you pull a shot. Cold water enters the boiler, the thermoblock mass cools, and a pure PID loop overshoots or undershoots while it catches up. Feedforward injects a calculated amount of heater power the instant brew is detected, so the dip is smaller and recovery is faster. Again, this is firmware. No wiring. No reason not to enable it.

Pre-infusion is different. It uses the 3-way solenoid to wet the puck at low pressure for a second or two before the full 9-bar shot. The firmware supports it cleanly. The hardware does not. You wire into the 3-way solenoid circuit, which is mains voltage. You add a driver, typically an SSR or relay, sized to the solenoid's current. You plumb the timing so the valve does not buzz or overheat. And you accept that a failure mode is a stuck-open solenoid, which vents boiler pressure through the group head. Pre-infusion produces a better shot, no question. But it is a second hardware project on top of the first. Get the PID stable first. Come back to pre-infusion on build two.

Key takeaway: Auto-tune and feedforward are free wins, always enable them. Pre-infusion is a hardware addition that belongs on your second build, not your first.

What parts go into a ranciliopid Silvia build?

Short answer: MCU, display, relay or SSR, temperature sensor, optional 3-way solenoid driver, power supply, optocoupler, wire, connectors, and optionally a BLE scale. The official PCB removes a class of wiring mistakes. Perfboard is for people who have already blown up an SSR.

The MCU is an ESP32 DevKitC v4. The display is a 128x64 OLED, I2C, SSD1306 or SH1106. The heater is switched through an SSR rated for your market voltage and at least 15 amps, or a mechanical relay if you do not mind the shorter life. The temperature sensor is a PT100 or PT1000 RTD through an amplifier; the legacy ESP8266 line supported DS18B20 and TSic306, and those still work on older builds. For pre-infusion, add a second relay or SSR for the 3-way solenoid. The PSU is a 5V buck converter tapped off the machine's supply, or an external wall wart. The optocoupler reads the brew switch without cutting its wire. Use silicone-jacketed high-temperature wire near the boiler. Connectors on the official PCB are JST-XH.

Key takeaway: Budget for the official CleverCoffee PCB if you are new. It removes the most common wiring mistakes. Optional add-ons: BLE scale, pressure sensor, rotary encoder, printed case. Perfboard is for second builds, not first ones.

Where do ranciliopid builds go wrong, and when do I stop?

Short answer: Builds go wrong in four places: misidentified mains wiring, SSR current leakage, thermal runaway from a disconnected sensor, and 3-way solenoid buzzing from wrong duty cycle. Each has a clear stop condition. Learn them before you power up.

Stop condition one is misidentified mains. If you cannot confirm line, neutral, and protective earth on your actual machine with a meter, stop. Read the handbook's wiring diagram for your version first. Stop condition two is SSR leakage. A solid-state relay can fail partially on, passing current to the heater even when the PID says off. Power up, let the machine sit idle ten minutes in standby, feel the boiler. If it is warm, your SSR is leaking. Replace it. Stop condition three is thermal runaway. If the PT100 reads 110 degrees and the heater relay has not cut, your sensor is disconnected or your PID is misconfigured. Kill power at the wall. Stop condition four is solenoid buzz. If the 3-way valve buzzes or heats during pre-infusion, your duty cycle is wrong. Re-check driver wiring and firmware config.

Key takeaway: Four stop conditions: misidentified mains, SSR leakage, thermal runaway, solenoid buzz. I have seen each on real builds by careful people. Test after each wiring step, not at the end. Wire cold, fuse everything, keep a fire extinguisher close.

How do I earn the full iFixit-level install walkthrough?

Short answer: The full step-by-step install with real photos, not stock diagrams, is gated behind four things: you have a real Silvia on your bench, you can send photos of your nameplate and wiring, you own and know how to use a meter, and you accept the L3 risk. The official handbook is the primary source.

I am not going to pretend a web page can replace a proper install guide. The official handbook at manual.rancilio-pid.de is the source of truth for the actual wiring, pin mapping, and configuration. It has been maintained for over five years, used on hundreds of machines, and has a Discord behind it for edge cases. Read it before you buy a single part. Then come back with your machine's nameplate photo, a clear shot of your internal wiring, and a yes or no on pre-infusion, and we can walk the install specific to your Silvia.

The reason I gate the full walkthrough behind those four conditions is that a generic install guide kills machines. Wire colors change between production runs. Market voltages change SSR sizing. Pre-infusion changes the solenoid driver. If I write one walkthrough, it is wrong for half of you. If I write one that asks for your specific machine first, it is right for all of you. Get the machine on your bench. Photograph the nameplate. Confirm you have a meter and know how to use it. Accept that this is L3 work and you own the risk. Then we do the install properly.

Key takeaway: Read the official handbook first. Bring your machine's nameplate photo, your wiring photo, and a meter. Then the full install walkthrough makes sense for your specific Silvia.

Frequently asked questions

Can I run ranciliopid on a NodeMCU I already have in a drawer?

You can, but only on the legacy firmware branch, which is pre-v4.0.0. You give up the browser web flasher, the JSON config, BLE scale support, and any feature shipped since the ESP32 transition. The NodeMCU costs three dollars less than an ESP32 DevKitC v4. The trade is not worth it. Buy the ESP32. The legacy branch gets no new features and only critical bugfixes, if that.

Do I need the official CleverCoffee PCB?

No, but it removes the most common wiring mistakes. The official PCB handles the ESP32 pin mapping, the SSR driver circuit, the temperature sensor amplifier, and the optocoupler isolation in one board. Perfboard works if you have done mains wiring before and can read a schematic. If this is your first espresso machine mod, buy the PCB. The cost is modest compared to a wiring mistake on a 230V heater circuit. The CleverCoffee shop at shop.clevercoffee.de carries it.

Will the ranciliopid board fit inside my Silvia?

Yes, with planning. The official PCB has a small footprint and was designed to fit inside the Silvia's base enclosure. People have also mounted it in a 3D-printed case on the back, or in an external project box with a cable run to the machine. External mounting is easier to service and to reverse. Internal mounting is cleaner aesthetically. Both work. Measure your space before you commit, and remember that the SSR needs airflow, not a sealed box.

Is the pre-infusion mod reversible?

Mostly yes. The pre-infusion wiring taps into the 3-way solenoid circuit. You can restore original wiring in roughly thirty minutes if you labeled everything when you installed it, which you should have. The PID itself is similarly reversible. You pull the ESP32, reconnect the stock thermostat, put the stock brew switch wiring back. The only permanent modification most builds make is a hole for the display or cable pass-through, and even that can be filled.

What about Gaggia or Quickmill machines?

The CleverCoffee firmware supports Gaggia and Quickmill as well as Rancilio Silvia. The pin mapping, configuration, and brew switch logic all differ. This page does not cover those machines. If you are running a Gaggia Classic, the Gaggiuino planner is the better starting point. For Quickmill, read the CleverCoffee handbook's machine-specific section and join the Discord for guidance.