| """Tiny Computer Agent - an agentic harness that drives a real computer with a |
| tiny, fully local model. |
| |
| The harness is deliberately boring: it owns the loop, the closed action vocabulary, |
| perception and the safety gates, so the model only ever answers one question - |
| "which item from this short menu, and which verb?" Nothing here needs a network |
| call at run time, and the core imports nothing outside the standard library. |
| |
| from tiny_computer_agent import AgentLoop, GrabScreen, IndexedScreen, OcrDetector |
| from tiny_computer_agent.models import TextPlannerBrain |
| |
| screen = IndexedScreen(GrabScreen(), OcrDetector()) # pixels -> labels |
| brain = TextPlannerBrain() # 0.5B, CPU-friendly |
| loop = AgentLoop(screen=screen, brain=brain) # dry run by default |
| episode = loop.run("save the document") |
| print(episode.render()) |
| |
| An episode can be saved as a portable *trace*, replayed offline, and scored, so |
| "the model looked plausible on that screenshot" becomes a number: |
| |
| from tiny_computer_agent import Trace, benchmark, run_scenario |
| |
| trace = run_scenario(Scenario("click 'Save'", frames=[...], expected="Save"), brain) |
| trace.save("traces/save.json") # diffable, no pixels |
| print(benchmark(scenarios, {"planner": lambda s: PlannerBrain()}).render()) |
| """ |
|
|
| from tiny_computer_agent.accessibility import ( |
| INTERACTIVE_ROLES, |
| TEXT_ROLES, |
| AccessibleNode, |
| AtspiDetector, |
| AtspiReader, |
| TreeReader, |
| UiaDetector, |
| UiaReader, |
| accessibility_available, |
| ) |
| from tiny_computer_agent.audit import ( |
| AuditEntry, |
| AuditLog, |
| observation_digest, |
| read_audit, |
| verify_audit, |
| ) |
| from tiny_computer_agent.act import ( |
| ActionResult, |
| DryRunExecutor, |
| Executor, |
| InputUnavailable, |
| PyAutoGuiExecutor, |
| resolve_point, |
| ) |
| from tiny_computer_agent.actions import ( |
| ACTION_KINDS, |
| ACTION_MENU, |
| Action, |
| ActionError, |
| parse_action, |
| ) |
| from tiny_computer_agent.brain import ( |
| Brain, |
| BrainError, |
| DecisionMenu, |
| GoalUnreachable, |
| MenuItem, |
| MockBrain, |
| ModelBrain, |
| PlannerBrain, |
| extract_json_object, |
| extract_json_objects, |
| parse_decision, |
| ) |
| from tiny_computer_agent.loop import AgentLoop, Episode, Step |
| from tiny_computer_agent.models import ( |
| DEFAULT_TEXT_MODEL, |
| DEFAULT_VISION_MODEL, |
| MODEL_BRAINS, |
| TextPlannerBrain, |
| VLMBrain, |
| make_model_brain, |
| model_cached, |
| model_dependencies, |
| pick_dtype, |
| resolve_device, |
| ) |
| from tiny_computer_agent.demo import fake_desktop, write_fake_desktop |
| from tiny_computer_agent.observe import ( |
| Element, |
| FakeScreen, |
| GrabScreen, |
| ImageScreen, |
| Observation, |
| ScreenSource, |
| ScreenUnavailable, |
| normalise_label, |
| ) |
| from tiny_computer_agent.desktop import ( |
| BRAIN_NAMES, |
| DEFAULT_KILL_SWITCH, |
| Check, |
| build_agent, |
| display_available, |
| doctor, |
| run_checks, |
| ) |
| from tiny_computer_agent.perception import ( |
| AutoDetector, |
| Detector, |
| DetectorUnavailable, |
| GridDetector, |
| IndexedScreen, |
| OcrDetector, |
| detector_available, |
| make_detector, |
| ) |
| from tiny_computer_agent.diff import ChangeVerifier, Delta, diff, element_key |
| from tiny_computer_agent.gates import ( |
| READ_ONLY_KINDS, |
| AllOf, |
| AllowAll, |
| AllowOnlyLabels, |
| AnyOf, |
| Approval, |
| DenyAll, |
| Gate, |
| InteractiveGate, |
| gate_from_spec, |
| mutating, |
| ) |
| from tiny_computer_agent.runner import RunReport, Task, TaskOutcome, TaskRunner |
| from tiny_computer_agent.safety import Policy, PolicyViolation |
| from tiny_computer_agent.skills import ( |
| DEFAULT_SKILLS_PATH, |
| Skill, |
| SkillBrain, |
| SkillLibrary, |
| SkillStep, |
| record_skill, |
| slug, |
| ) |
| from tiny_computer_agent.watchdog import Watchdog, WatchdogTimeout |
| from tiny_computer_agent.trace import ( |
| Scenario, |
| Scoreboard, |
| Trace, |
| TraceStep, |
| Verdict, |
| benchmark, |
| benchmark_traces, |
| load_traces, |
| run_scenario, |
| score, |
| score_replay, |
| score_trace, |
| ) |
|
|
| __version__ = "2.0.0" |
|
|
| __all__ = [ |
| "ACTION_KINDS", "ACTION_MENU", "AccessibleNode", "Action", |
| "ActionError", "ActionResult", "AgentLoop", "AllOf", |
| "AllowAll", "AllowOnlyLabels", "AnyOf", "Approval", |
| "AtspiDetector", "AtspiReader", "AuditEntry", "AuditLog", |
| "AutoDetector", "BRAIN_NAMES", "Brain", "BrainError", |
| "ChangeVerifier", "Check", "DEFAULT_KILL_SWITCH", "DEFAULT_SKILLS_PATH", |
| "DEFAULT_TEXT_MODEL", "DEFAULT_VISION_MODEL", "DecisionMenu", "Delta", |
| "DenyAll", "Detector", "DetectorUnavailable", "DryRunExecutor", |
| "Element", "Episode", "Executor", "FakeScreen", |
| "Gate", "GoalUnreachable", "GrabScreen", "GridDetector", |
| "INTERACTIVE_ROLES", "ImageScreen", "IndexedScreen", "InputUnavailable", |
| "InteractiveGate", "MODEL_BRAINS", "MenuItem", "MockBrain", |
| "ModelBrain", "Observation", "OcrDetector", "PlannerBrain", |
| "Policy", "PolicyViolation", "PyAutoGuiExecutor", "READ_ONLY_KINDS", |
| "RunReport", "Scenario", "Scoreboard", "ScreenSource", |
| "ScreenUnavailable", "Skill", "SkillBrain", "SkillLibrary", |
| "SkillStep", "Step", "TEXT_ROLES", "Task", |
| "TaskOutcome", "TaskRunner", "TextPlannerBrain", "Trace", |
| "TraceStep", "TreeReader", "UiaDetector", "UiaReader", |
| "VLMBrain", "Verdict", "Watchdog", "WatchdogTimeout", |
| "__version__", "accessibility_available", "benchmark", "benchmark_traces", |
| "build_agent", "detector_available", "diff", "display_available", |
| "doctor", "element_key", "extract_json_object", "extract_json_objects", |
| "fake_desktop", "gate_from_spec", "load_traces", "make_detector", |
| "make_model_brain", "model_cached", "model_dependencies", "mutating", |
| "normalise_label", "observation_digest", "parse_action", "parse_decision", |
| "pick_dtype", "read_audit", "record_skill", "resolve_device", |
| "resolve_point", "run_checks", "run_scenario", "score", |
| "score_replay", "score_trace", "slug", "verify_audit", |
| "write_fake_desktop", |
| ] |
|
|
