Skip to main content

URI control system managers/controllers over separate uri* capability packs.

Project description

urisys

AI Cost Tracking

PyPI Version Python License AI Cost Human Time Model

  • 🤖 LLM usage: $15.6735 (109 commits)
  • 👤 Human dev: ~$3566 (35.7h @ $100/h, 30min dedup)

Generated on 2026-06-18 using openrouter/qwen/qwen3-coder-next


Centralny URI control plane dla TellMesh: CLI (urisys), managers, Markpact oraz monorepo obrazów Docker z edge runtime.

Instalacja

pip install urisys

Dev (checkout tellmesh)

Wymaga checkout tellmesh workspaceurisys obok sibling repos (uriresolver/, uricore/, urisys-node/, urikvm/, …).

cd tellmesh/urisys

python3 -m venv .venv
source .venv/bin/activate

uv sync --extra kvm    # [tool.uv.sources] → ../{pack}

Po instalacji CLI:

urisys --help
which urisys   # → .venv/bin/urisys

Zależności runtime: uricore (tellmesh wheel z GitHub), uriresolver (resolve + transport delegate), paczki URI z uri-packs (dev group w pyproject.toml).

Mapa wszystkich paczek (diagramy, linki): docs/MESH.md.

Capability packi kvm/him/ocr/llm doinstalowują się lazy przy pierwszym URIdocs/NODE-SETUP.md.

# slave / lenovo
pip install -U urisys
urisys init
urisys node serve --host 0.0.0.0 --port 8790

Dev monorepo (wszystkie packi od razu):

uv sync --extra kvm

Każdy capability pack ma własny pyproject.toml (samodzielnie publikowalny na PyPI; zależy od uricore). Po publikacji: pip install urikvm urihim uriocr urillm. Na działającym node dogrywasz po połączeniu: POST /uri/pack {"pack":"kvm"} (wymaga URISYS_NODE_ALLOW_PACK_LOAD=1). Szczegóły: docs/DISTRIBUTION.md.

Szybki start

cd urisys && uv sync

# Pojedyncze URI (paczki z uri-packs)
urisys --packs browser call browser://default/page/open \
  --payload '{"url":"https://example.com"}' --approve

# Flow mock
urisys --packs all flow flows/device-maintenance.uri.flow.yaml --approve --dry-run

# HTTP server
urisys --packs all serve --port 8789

Docker lab (10 automatyzacji + RDP)

cd urisys-automation-lab
bash scripts/docker-up.sh
bash scripts/docker-smoke.sh

# Pełny test E2E
python3 scripts/run_test_sessions.py --sessions lab-10-flows
# lub: bash scripts/run-lab-e2e.sh

Dokumentacja

Indeks: docs/README.md — nawigacja, stan projektu, otwarte zadania.

Dokument Temat
docs/ECOSYSTEM.md Model warstw TellMesh
docs/MESH.md Mapa TellMesh — paczki → urisys, diagramy Mermaid
docs/NODE-SETUP.md Slaveurisys init, lazy install, hot-load, systemd
docs/DISTRIBUTION.md PyPI · Markpact · GitHub OCI — packi, kvm-release
docs/PACKAGES.md Layout tellmesh sibling repos, urioperators
docs/REPOS.md GitHub tellmesh vs semcod, mapowanie paczek
docs/PACK-EXTENSIBILITY.md Nowe schematy URI, forward, release_forwards
docs/OFFICE-AUTOMATION.md Automatyzacja biurowa — roadmap
docs/ARCHITECTURE.md Warstwy, runtime, porty Docker
docs/PROCESS-ARCHITECTURE.md UriProcess: Markpact → resolver → marksync
docs/FLOWS.md URI flows, uri2flow / uri3
docs/CLI.md Komendy CLI
docs/MARKPACT.md Markpact validate/compile/test
urisys-node/README.md Slave node, kvm packs, hot-load, forward OCI
urisys-node/docs/SCREEN_BACKENDS.md Wayland capture — portal, vdisplay, mss
urisys-node/docs/PAIRING.md Parowanie master ↔ slave
project/MAP.md Przewodnik po map.toon.yaml (code2llm)
project/PACKAGES.md Indeks paczek sync z mapą

Struktura (po migracji packów)

tellmesh/
├── urisys/              pip package — CLI + managers + docker glue ★
├── uriresolver/           intent router (resolve + transport)
├── uricore/             uri_control + uri_control.edge
├── urioperators/        wspólne helpery LLM
├── urisys-node/         urisysnode (bundled); uriscreen/urishell via pip
├── urikvm/ urihim/ uriocr/ urillm/ urirdp/ urishell/ urienv/ …
├── urikvmedge/          CLI urisys-kvm
├── urirdpedge/          CLI urisys-rdp
├── urirdp-docker/       RDP + URI stack (:8795 / :3389)
└── urisys-automation-lab/  lab UI (:8099)

Managers

  • PackManager — paczki uri*, manifest.yaml, Markpact
  • MarkpactManager — validate / compile / test *.markpact.md
  • RuntimeManageruri_control.UriControlRuntime
  • UriController — call, explain, routes
  • FlowController — sekwencyjne *.uri.flow.yaml
  • BridgeManager — forward do zdalnego /uri/call

Markpact

Thin pack Markpacts live in each capability repo: {pack}/markpacts/{pack}.markpact.md.

cd tellmesh/urisys
python3 scripts/generate_pack_markpacts.py --check   # CI drift guard
bash scripts/run-markpact-ci.sh                      # drift + validate + tests

cd tellmesh/urishell
export TELLMESH_ROOT=~/github/tellmesh
urisys markpact run markpacts/urishell.markpact.md --as flow --approve --dry-run

bash scripts/validate-all-markpacts.sh
bash examples/markpact/showcase-run-flow.sh          # uribrowser integration demo

# UriProcess: materialize + resolver per platform
export TELLMESH_ROOT=~/github/tellmesh
bash scripts/marksync-materialize.sh ../markpact-contracts/packs/desktop-automation-processes.markpact.md

Docs: docs/MARKPACT.md · docs/PROCESS-ARCHITECTURE.md · layout: markpacts/README.md

Pełna regresja (tellmesh workspace):

bash scripts/run-full-regression.sh

Analiza projektu (code2llm)

code2llm ./ -f all -o ./project
# → project/map.toon.yaml, calls.mmd, context.md

Ekosystem TellMesh

Orchestrator: urisys · Mapa: MESH.md · Model: ECOSYSTEM.md

Pole Wartość
Warstwa Orchestrator (centrum mesh)
Moduł urisys
Zależności uricontrol, uriresolver
Rola CLI, Markpact, flow runner, PackManager, urisys init

Runtime edge: uri_control.edge w pakiecie uricontrol (legacy PyPI uricore / urisysedge usunięty 2026-06). Resolver intencji: uriresolver (uri_resolver) + transport w uritransport; policy gate: uriguard (uri_guard).

License

Licensed under Apache-2.0.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

urisys-0.1.76.tar.gz (84.2 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

urisys-0.1.76-py3-none-any.whl (86.6 kB view details)

Uploaded Python 3

File details

Details for the file urisys-0.1.76.tar.gz.

File metadata

  • Download URL: urisys-0.1.76.tar.gz
  • Upload date:
  • Size: 84.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.7

File hashes

Hashes for urisys-0.1.76.tar.gz
Algorithm Hash digest
SHA256 9dd50621e4d4d88fa489dc27da6809b564b1530e7e1dfe77acaf6d7f6e568fe8
MD5 5dee604d1be361265cb23e0c27cd2ffd
BLAKE2b-256 cadc8470b52e85574d8676591e4cf5cd5c5c07957c85612608f44a156fcf5d16

See more details on using hashes here.

File details

Details for the file urisys-0.1.76-py3-none-any.whl.

File metadata

  • Download URL: urisys-0.1.76-py3-none-any.whl
  • Upload date:
  • Size: 86.6 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.7

File hashes

Hashes for urisys-0.1.76-py3-none-any.whl
Algorithm Hash digest
SHA256 fd13be41ce2a0bf796aed370b065dc1f4a6f6b168c3318904bf9ea9fa0dd6326
MD5 b089e8efd9174d3fe1ac846090cd4cde
BLAKE2b-256 3e25b05309768d31aba512db63262f7d9d41d9b9c5cd23bc01a624414f37899e

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page