{"id":22055269,"url":"https://github.com/getcuia/cuia","last_synced_at":"2025-05-12T15:35:34.290Z","repository":{"id":36975023,"uuid":"423897741","full_name":"getcuia/cuia","owner":"getcuia","description":"🧉🌿 A delightful tiny framework for building reliable text-based applications","archived":false,"fork":false,"pushed_at":"2023-03-07T05:04:56.000Z","size":479,"stargazers_count":19,"open_issues_count":9,"forks_count":1,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-05-06T08:54:27.132Z","etag":null,"topics":["ansi","cli","command-line","console","cuia","elm-architecture","framework","functional","gui","python","simple","terminal","terminal-based","toolkit","tui","ui","user-interface"],"latest_commit_sha":null,"homepage":"https://pypi.org/project/cuia/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/getcuia.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2021-11-02T15:27:14.000Z","updated_at":"2024-11-06T04:01:58.000Z","dependencies_parsed_at":"2023-02-18T03:00:37.900Z","dependency_job_id":null,"html_url":"https://github.com/getcuia/cuia","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/getcuia%2Fcuia","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/getcuia%2Fcuia/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/getcuia%2Fcuia/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/getcuia%2Fcuia/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/getcuia","download_url":"https://codeload.github.com/getcuia/cuia/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253766464,"owners_count":21960924,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ansi","cli","command-line","console","cuia","elm-architecture","framework","functional","gui","python","simple","terminal","terminal-based","toolkit","tui","ui","user-interface"],"created_at":"2024-11-30T16:06:09.059Z","updated_at":"2025-05-12T15:35:34.249Z","avatar_url":"https://github.com/getcuia.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"[![PyPI](https://img.shields.io/pypi/v/cuia)](https://pypi.org/project/cuia/)\n[![Python package](https://github.com/getcuia/cuia/actions/workflows/python-package.yml/badge.svg)](https://github.com/getcuia/cuia/actions/workflows/python-package.yml)\n[![PyPI - License](https://img.shields.io/pypi/l/cuia)](https://github.com/getcuia/cuia/blob/main/LICENSE)\n\n# [cuia](https://github.com/getcuia/cuia#readme) 🧉\n\n\u003cdiv align=\"center\"\u003e\n    \u003cimg class=\"hero\" src=\"https://github.com/getcuia/cuia/raw/main/banner.svg\" alt=\"cuia\" width=\"33%\" /\u003e\n\u003c/div\u003e\n\n\u003e A delightful tiny framework for building reliable text-based applications.\n\n**cuia** is a tiny Python library for building interactive terminal user\ninterfaces that are easy to use, fast and have a small memory footprint.\n\ncuia is inspired by [Bubble Tea](https://github.com/charmbracelet/bubbletea)\n(written in [Go](https://golang.org/)) and, in particular, employs\n[the Elm architecture](https://guide.elm-lang.org/architecture/) (TEA, named\nafter the [Elm programming language](https://elm-lang.org/)). This means that\n**cuia applications are as dynamic and easy to write (and use) as they could\nbe**.\n\n## Features\n\n-   🧵 Simple: your user interface is a string of characters\n-   💬 Interaction-focused\n-   ♻️ Easily integrate with other libraries\n-   🕹️ Use the same escape code sequences\n    [as you would with Colorama](https://github.com/tartley/colorama#recognised-ansi-sequences)\n-   🖥️ Support for Unix variants out of the box:\n    [curses](https://docs.python.org/3/library/curses.html) under the hood by\n    default (and probably works on Windows and DOS if a compatible curses\n    library is available)\n-   🤬 Only one dependency: [cusser](https://github.com/getcuia/cusser) (for\n    wrapping the curses library)\n-   🐍 Python 3.8+\n\n## Installation\n\n```console\n$ pip install cuia\n```\n\n## Usage\n\n```python\nIn [1]: import asyncio\n\nIn [2]: from dataclasses import dataclass\n\nIn [3]: from cuia import Program, Store\n\nIn [4]: @dataclass\n   ...: class Hello(Store):\n   ...:\n   ...:     x: int = 0\n   ...:     y: int = 0\n   ...:\n   ...:     def __str__(self):\n   ...:         return f\"\\033[{self.x};{self.y}H\\033[1mHello, 🌍!\"\n   ...:\n\nIn [5]: program = Program(Hello(34, 12))\n\nIn [6]: asyncio.run(program.start())\n\n```\n\n![Screenshot](https://github.com/getcuia/cuia/raw/main/screenshot.png)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgetcuia%2Fcuia","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgetcuia%2Fcuia","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgetcuia%2Fcuia/lists"}