Metadata-Version: 2.4
Name: cuifw
Version: 1.6.6
Summary: Console User Interface Framework - the GUI framework for the terminal
Home-page: https://github.com/suleiman/cuifw
Author: Suleiman
Author-email: steal.apet@mail.ru
License: MIT
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: author
Dynamic: author-email
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: license
Dynamic: license-file
Dynamic: requires-python
Dynamic: summary

# cuifw

> **C**onsole **U**ser **I**nterface **F**rame**W**ork
> The GUI framework for the terminal.

`cuifw` is what `tkinter` is for the desktop - but for the terminal.

- GUI widgets: Label, Button, Menu, Panel, Input, Table, Slider, Tabs
- 2D + 3D ASCII rendering: lines, circles, hearts, cubes, spheres, torus
- Dialogs: MessageBox, InputDialog, FileDialog
- Layout: VSTACK, HSTACK, GRID
- Themes: Style, Theme, dark/light
- Events: EventBus, FocusManager
- Keyboard: raw mode, arrows, Enter, Esc, F-keys
- Network: Channel (sockets), Web (HTTP server)
- Process: StartPyCode, KillPyScript, WaitForProcess

Works everywhere Python runs: Linux, macOS, Windows, Android (Pydroid3),
SSH, Docker, CI.

## Install

    pip install cuifw

## Quick start

    from cuifw import Colors, Render, Canvas, MessageBox

    print(Colors.colorize("Hello, world!", Colors.GREEN))

    points = Render.get_heart_points(40, 12, size=8, char='@', color=Colors.RED)
    Render.DrawPic(points, width=80, height=25)

    canvas = Canvas(80, 24)
    MessageBox.showinfo(canvas, "Welcome", "Hello, Suleiman!")

## License

MIT - see LICENSE.

Author: **Suleiman** <steal.apet@mail.ru>
Copyright (c) Suleiman 2026
