CocktailBerry Hardware is the official hardware repository for the CocktailBerry project. It holds the machine designs (FreeCAD sources) and custom PCB(A)s (KiCad projects) you need to build your own CocktailBerry machine.
Build guides, parts lists, specifications, and downloadable fabrication files live in the Hardware Documentation. For the software, setup, and configuration, see the main CocktailBerry project and the Software Documentation.
Like this project? Give the main repo a star on GitHub! ⭐
Sources live in this repo; fabrication files (Gerbers/BOM/CPL for boards, STEP/STL for machines) are generated from them by the build pipeline. Full specs, parts, and downloads are on the Hardware Documentation.
PCBAs (pcb/) — control boards that replace relay arrays, switching pump circuits via MOSFETs:
| Board | Description | Status |
|---|---|---|
| CocktailBerryBoard GPIO | GPIO-based, up to 10 circuits | Released |
| CocktailBerryBoard Slim | Compact GPIO-based, up to 8 circuits | Released |
| CocktailBerryBoard I2C | I2C-based, up to 10 circuits | Alpha |
Machines (cad/) — 3D-printable machine builds:
| Machine | Description | Status |
|---|---|---|
| CocktailBerry MK III | Compact footprint with integrated touchscreen support | Released |
| CocktailBerry 2-Go | Portable Euro Box build with detachable legs | Released |
| CocktailBerry MK IV | v2 reference build, optional scale + peristaltic pumps | Beta |
Contributions are very welcome - a new machine design, an improved model, or a PCB layout. Open an issue or pull request.
Please submit source files only:
- PCBs: the KiCad project (
*.kicad_sch,*.kicad_pcb, and any local symbols/footprints) - Machines: the FreeCAD sources (
*.FCStd)
Do not commit generated fabrication artifacts (Gerbers, drill, CPL, STL, STEP) - those are
built from the sources by the pipeline (see pcb/README.md and
cad/README.md). See the main project's
Contributing Guidelines
for general rules.
| Project | Description |
|---|---|
| CocktailBerry | The main software project (Python + React) |
| CocktailBerry Addons | Community addons and extensions |
| Software Documentation | Software setup and configuration guides |


