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: $13.9089 (126 commits)
  • 👤 Human dev: ~$3799 (38.0h @ $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 host → zdalny lenovo
urisys remote health --endpoint http://192.168.188.201:8790
urisys remote restart --endpoint http://192.168.188.201: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.89.tar.gz (96.6 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.89-py3-none-any.whl (98.2 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: urisys-0.1.89.tar.gz
  • Upload date:
  • Size: 96.6 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.89.tar.gz
Algorithm Hash digest
SHA256 dfeef20bb0bdd6ef888dfd04971f621810e181ee9d8db2eee0b8d4f2e74013e6
MD5 65513861081b233d328c061c72046de0
BLAKE2b-256 ddad70f4cb9fbde706a52a5fa48fc8b6241956233754b9688fda7635ddea6b6b

See more details on using hashes here.

File details

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

File metadata

  • Download URL: urisys-0.1.89-py3-none-any.whl
  • Upload date:
  • Size: 98.2 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.89-py3-none-any.whl
Algorithm Hash digest
SHA256 2f2ea728be1b1242b4230a52d7b53299afc3033f1969c7416139eedcba39e133
MD5 686b25cd86ffcad29bce742eb486f8c7
BLAKE2b-256 ce8f8f73979f16990ed17f608453cf2ccf55781061bcd8bc53f8a2a121bdbaf9

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