Skip to main content

Python SDK and CLI for ScreenLane — screen-aware voice command layer for AI agents

Project description

ScreenLane (Python)

Screen-aware voice / text command layer for AI agents — capture screen context, dictate intent, route commands to Codra, Tera, and other targets.

Part of Talocode.

Package pip install talocode-screenlane
Import from talocode_screenlane import ScreenLaneClient
CLI screenlane-py
Local default http://127.0.0.1:3070
Cloud https://api.talocode.site + TALOCODE_API_KEY
Repo github.com/talocode/screenlane
License MIT

Why ScreenLane?

Agents often lack what’s on the user’s screen. ScreenLane sits between:

  1. Capture — screen / context text
  2. Intent — voice transcript or typed command
  3. Route — structured command for Codra, Tera, GateLane, etc.

Open-source local server + cloud routes so you can demo offline and scale with Talocode Cloud.


Install

pip install -U talocode-screenlane

Python 3.10+.


Quickstart

Local server

# In the ScreenLane Node package / monorepo:
# screenlane serve   → http://127.0.0.1:3070

from talocode_screenlane import ScreenLaneClient

client = ScreenLaneClient()  # local default

print(client.health())
print(client.doctor())
print(client.demo())

result = client.command({
    "text": "Fix this error",
    "contextText": "TypeError: Cannot read properties of undefined",
    "target": "codra",
})
print(result)

Cloud

import os
from talocode_screenlane import ScreenLaneClient

cloud = ScreenLaneClient(
    base_url="https://api.talocode.site",
    api_key=os.environ["TALOCODE_API_KEY"],
)

cloud.command({
    "text": "Summarize this screen",
    "contextText": "...",
    "target": "tera",
})

Environment

Variable Purpose
TALOCODE_API_KEY Cloud auth
TALOCODE_BASE_URL Optional cloud base
Local URL Passed as base_url / client default http://127.0.0.1:3070

Client API

Method Purpose
health() Liveness
doctor() Dependency / config checks
capture(payload) Screen / context capture
dictate(payload) Speech / text dictation
command(payload) Build / run agent command
send(payload) Dispatch to target
list_contexts() Known contexts
list_commands() Command catalog
demo() Deterministic demo flow

Typical payload fields: text, contextText, target, sessionId, offline flags (see CLI).


CLI

screenlane-py --help
screenlane-py demo
screenlane-py command --text "Fix this error" --context-text "..." --offline

How it fits Talocode

User screen / voice
        ↓
   ScreenLane (this)
        ↓
  Codra / Tera / GateLane / custom target

Pair with Codra for code fixes and Tera for general LLM actions.


Related packages

Package Role
talocode-screenlane This package
talocode-codra Coding agent target
talocode-tera Chat / rewrite target
talocode Unified cloud client

Talocode ecosystem

Project Role
ScreenLane This product
Codra Coding agent
Tera AI capabilities
GateLane MCP gateway
StackLane Cloud control plane

docs.talocode.site · github.com/talocode

License

MIT © Talocode

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

talocode_screenlane-0.1.3.tar.gz (5.8 kB view details)

Uploaded Source

Built Distribution

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

talocode_screenlane-0.1.3-py3-none-any.whl (6.2 kB view details)

Uploaded Python 3

File details

Details for the file talocode_screenlane-0.1.3.tar.gz.

File metadata

  • Download URL: talocode_screenlane-0.1.3.tar.gz
  • Upload date:
  • Size: 5.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.5

File hashes

Hashes for talocode_screenlane-0.1.3.tar.gz
Algorithm Hash digest
SHA256 e7dc9a33c0c8437e5c31f47b4184353d72762b48e423aac500ac49659bf27666
MD5 a35da7bacef6e05fbc32949d07dbc299
BLAKE2b-256 ae3f7312ebaae78ab029c4c4732b008f74bf3bd0890070ddf1550ce7126818c1

See more details on using hashes here.

File details

Details for the file talocode_screenlane-0.1.3-py3-none-any.whl.

File metadata

File hashes

Hashes for talocode_screenlane-0.1.3-py3-none-any.whl
Algorithm Hash digest
SHA256 45fb9be6e5219ff015022d7b0bfbb60142b5065d68144e6c396a67ffeaefc998
MD5 e528998243811c65eaac1e6e2ee88ac0
BLAKE2b-256 14cf598e750e8b39b9af7cb16eefbbe6e1a480e2bf4172f18686d2773374c1f1

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