Quick Start
Create your first ucharm app in 5 minutes
Quick Start
Let's build a simple CLI app that demonstrates ucharm's key features.
Create a Project
mkdir hello-cli && cd hello-cli
ucharm initWrite Your App
Create app.py:
from ucharm import box, success, error, select, confirm
import charm
# Show a welcome box
box("Welcome to Hello CLI!", title="Hello", border_color="cyan")
# Interactive selection
action = select("What would you like to do?", [
"Say hello",
"Show a table",
"Exit"
])
if action == "Say hello":
name = input("What's your name? ")
success(f"Hello, {name}!")
elif action == "Show a table":
charm.table([
["Language", "Status"],
["Python", "Supported"],
["Zig", "Native"],
], headers=True, border="rounded")
elif action == "Exit":
if confirm("Are you sure?"):
error("Goodbye!")Run It
ucharm run app.pyBuild a Binary
# Build for current platform
ucharm build app.py -o hello
# Build universal binary (works on any machine)
ucharm build app.py -o hello --mode universal
# Run the binary
./hello