USEE: Software that assembles like LEGO pieces

An open protocol for creating interchangeable software pieces,
understandable and resilient over time.

Today's software is broken

⚠️

UNNECESSARY COMPLEXITY

Programs that should do one thing, do a hundred.

ACCELERATED OBSOLESCENCE

Systems that should last decades break in months.

🚧

HIGH ENTRY BARRIER

Tools that should be accessible require years to learn.

🔒

CONTEXT DEPENDENCY

Solutions that should be universal only work in specific places.

"Every project reinvents the wheel. Login, QR, analytics, validations...
over and over again, with the same mistakes."

USEE: Four principles, software that lasts

U

USEFUL

Solves a concrete problem that people have today

S

SIMPLE

Few parts, low complexity, easy to understand

E

ESSENTIAL

Does one thing completely without extras

E

ENDURING

Resilient to changes, works years later

Pieces that speak the same language

Universal communication via plain text

(USEE Text Format)

Terminal
APIs
Web
Legacy
Each piece receives text → processes → returns text
No complex dependencies, no mandatory configuration
Works with any language: JavaScript, Python, Go, Rust, etc.

Anatomy of a USEE piece

File structure:

generate-qr/
├── PIECE.usee ← Metadata
├── README.md ← Documentation
├── run ← Entry point
├── INPUT.example
└── OUTPUT.example

Usage example:

# Input
text: https://my-site.com
width: 256
# Output
status: ok
format: png
image: iVBORw0KGgo... (base64)

"One piece = One problem solved. Documented, tested, ready to use."

The power is in composition

extract data

Gets info from a source

temporal analytics

Calculates metrics by period

generate report

Produces the final document
./extract-data | ./temporal-analytics | ./generate-report

"Build complex solutions by connecting simple pieces.
No extra code, no configuration, no headaches."

Explore the protocol

📄

USEE Manifesto

The 4 principles and philosophy of the protocol

Download
📄

Piece Anatomy

Structure and mandatory files for each piece

Download
📄

FTU Specification

USEE Text Format — complete syntax

Download
📄

Adapters Guide

How to expose pieces via JSON and HTTP

Download
📄

Verifier Guide

Automatic piece validation system

Download

Getting started

Learn to run and connect USEE pieces in minutes

📚

Quick Guide: Running and Connecting USEE Pieces

Everything you need to know to use USEE pieces: UTF format, basic execution, pipe connections, JSON/HTTP adapters, and complete practical examples.

  • USEE Text Format (UTF)
  • How to run a piece
  • Connect pieces with pipes
  • JSON and HTTP adapters
  • Debug and common errors
Download

Integration scripts

Ready-to-use tools and examples

ejemplo-pipeline.sh

Pipeline connecting analytics-temporal → generar-qr

🔄

transformar-ftu.sh

Utility to transform UTF fields between pieces

Example pieces

Explore real USEE pieces to understand the protocol structure

images v1.0.0

generar-qr

Generates customizable QR codes from text

qr image png
reports v1.0.0

analytics-temporal

Processes visit data in temporal periods with aggregations

analytics statistics metrics