use-computer 0.0.2__tar.gz → 0.0.3__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (42) hide show
  1. use_computer-0.0.3/PKG-INFO +98 -0
  2. use_computer-0.0.3/README.md +76 -0
  3. {use_computer-0.0.2 → use_computer-0.0.3}/pyproject.toml +2 -2
  4. use_computer-0.0.2/PKG-INFO +0 -49
  5. use_computer-0.0.2/README.md +0 -27
  6. {use_computer-0.0.2 → use_computer-0.0.3}/.env.example +0 -0
  7. {use_computer-0.0.2 → use_computer-0.0.3}/.gitignore +0 -0
  8. {use_computer-0.0.2 → use_computer-0.0.3}/.pre-commit-config.yaml +0 -0
  9. {use_computer-0.0.2 → use_computer-0.0.3}/examples/ios_quickstart.py +0 -0
  10. {use_computer-0.0.2 → use_computer-0.0.3}/examples/quickstart.py +0 -0
  11. {use_computer-0.0.2 → use_computer-0.0.3}/examples/setup_with_exec.py +0 -0
  12. {use_computer-0.0.2 → use_computer-0.0.3}/examples/upload_file.py +0 -0
  13. {use_computer-0.0.2 → use_computer-0.0.3}/mmini/__init__.py +0 -0
  14. {use_computer-0.0.2 → use_computer-0.0.3}/mmini/ax_transpile.py +0 -0
  15. {use_computer-0.0.2 → use_computer-0.0.3}/mmini/client.py +0 -0
  16. {use_computer-0.0.2 → use_computer-0.0.3}/mmini/display.py +0 -0
  17. {use_computer-0.0.2 → use_computer-0.0.3}/mmini/errors.py +0 -0
  18. {use_computer-0.0.2 → use_computer-0.0.3}/mmini/ios/__init__.py +0 -0
  19. {use_computer-0.0.2 → use_computer-0.0.3}/mmini/ios/apps.py +0 -0
  20. {use_computer-0.0.2 → use_computer-0.0.3}/mmini/ios/environment.py +0 -0
  21. {use_computer-0.0.2 → use_computer-0.0.3}/mmini/ios/input.py +0 -0
  22. {use_computer-0.0.2 → use_computer-0.0.3}/mmini/macos/__init__.py +0 -0
  23. {use_computer-0.0.2 → use_computer-0.0.3}/mmini/macos/keyboard.py +0 -0
  24. {use_computer-0.0.2 → use_computer-0.0.3}/mmini/macos/mouse.py +0 -0
  25. {use_computer-0.0.2 → use_computer-0.0.3}/mmini/models.py +0 -0
  26. {use_computer-0.0.2 → use_computer-0.0.3}/mmini/parsers.py +0 -0
  27. {use_computer-0.0.2 → use_computer-0.0.3}/mmini/py.typed +0 -0
  28. {use_computer-0.0.2 → use_computer-0.0.3}/mmini/recording.py +0 -0
  29. {use_computer-0.0.2 → use_computer-0.0.3}/mmini/retry.py +0 -0
  30. {use_computer-0.0.2 → use_computer-0.0.3}/mmini/sandbox.py +0 -0
  31. {use_computer-0.0.2 → use_computer-0.0.3}/mmini/screenshot.py +0 -0
  32. {use_computer-0.0.2 → use_computer-0.0.3}/mmini/tasks/__init__.py +0 -0
  33. {use_computer-0.0.2 → use_computer-0.0.3}/mmini/tasks/templates/pre_command.sh +0 -0
  34. {use_computer-0.0.2 → use_computer-0.0.3}/mmini/tasks/templates/task.toml +0 -0
  35. {use_computer-0.0.2 → use_computer-0.0.3}/mmini/tasks/templates/test_ios.sh +0 -0
  36. {use_computer-0.0.2 → use_computer-0.0.3}/mmini/tasks/templates/test_ios_nograder.sh +0 -0
  37. {use_computer-0.0.2 → use_computer-0.0.3}/mmini/tasks/templates/test_macos.sh +0 -0
  38. {use_computer-0.0.2 → use_computer-0.0.3}/mmini/tasks/templates/test_macos_check.sh +0 -0
  39. {use_computer-0.0.2 → use_computer-0.0.3}/mmini/tasks/templates/test_macos_nograder.sh +0 -0
  40. {use_computer-0.0.2 → use_computer-0.0.3}/use_computer/__init__.py +0 -0
  41. {use_computer-0.0.2 → use_computer-0.0.3}/use_computer/py.typed +0 -0
  42. {use_computer-0.0.2 → use_computer-0.0.3}/uv.lock +0 -0
@@ -0,0 +1,98 @@
1
+ Metadata-Version: 2.4
2
+ Name: use-computer
3
+ Version: 0.0.3
4
+ Summary: Python SDK for the use.computer macOS and iOS Computer Use API
5
+ Project-URL: Homepage, https://use.computer
6
+ Project-URL: Documentation, https://api.use.computer/docs
7
+ Project-URL: Repository, https://github.com/josancamon19/use-computer-python
8
+ Author: use.computer
9
+ Keywords: automation,computer-use,ios,macos,sandbox
10
+ Classifier: Development Status :: 3 - Alpha
11
+ Classifier: Intended Audience :: Developers
12
+ Classifier: Operating System :: OS Independent
13
+ Classifier: Programming Language :: Python :: 3
14
+ Classifier: Programming Language :: Python :: 3.10
15
+ Classifier: Programming Language :: Python :: 3.11
16
+ Classifier: Programming Language :: Python :: 3.12
17
+ Classifier: Programming Language :: Python :: 3.13
18
+ Classifier: Typing :: Typed
19
+ Requires-Python: >=3.10
20
+ Requires-Dist: httpx>=0.27
21
+ Description-Content-Type: text/markdown
22
+
23
+ # use-computer Python SDK
24
+
25
+ Python client for use.computer macOS and iOS sandboxes.
26
+
27
+ ```bash
28
+ pip install use-computer
29
+ export USE_COMPUTER_API_KEY=mk_live_...
30
+ ```
31
+
32
+ ```python
33
+ from use_computer import Computer
34
+
35
+ computer = Computer()
36
+ sandbox = computer.create() # macOS
37
+
38
+ try:
39
+ png = sandbox.screenshot.take_full_screen()
40
+ sandbox.mouse.click(500, 400)
41
+ sandbox.keyboard.type("hello")
42
+ sandbox.exec_ssh("open -a TextEdit")
43
+ finally:
44
+ sandbox.close()
45
+ computer.close()
46
+ ```
47
+
48
+ ## iOS
49
+
50
+ ```python
51
+ from use_computer import Computer
52
+
53
+ computer = Computer()
54
+ ios = computer.create(type="ios")
55
+ try:
56
+ ios.apps.open_url("https://example.com")
57
+ ios.input.tap(200, 300)
58
+ ios.input.type_text("hello")
59
+ ios.environment.set_appearance("dark")
60
+ finally:
61
+ ios.close()
62
+ computer.close()
63
+ ```
64
+
65
+ ## Action DSL
66
+
67
+ Actions are dotted method calls plus args/kwargs. They are useful when a model emits tool-like steps. Given an open macOS `sandbox`:
68
+
69
+ ```python
70
+ from use_computer import Action, parse_pyautogui, parse_xdotool
71
+
72
+ actions = [
73
+ Action("mouse.move", [500, 400]),
74
+ Action("mouse.click", [500, 400]),
75
+ Action("keyboard.hotkey", ["command+space"]),
76
+ Action("keyboard.type", ["Safari"]),
77
+ Action("screenshot.take_full_screen"),
78
+ ]
79
+
80
+ for action in actions:
81
+ action.execute(sandbox)
82
+
83
+ for action in parse_pyautogui("pyautogui.click(100, 200); pyautogui.write('hi')"):
84
+ action.execute(sandbox)
85
+
86
+ for action in parse_xdotool("xdotool mousemove 100 200 click 1 type hello"):
87
+ action.execute(sandbox)
88
+ ```
89
+
90
+ Common macOS targets: `mouse.*`, `keyboard.*`, `screenshot.*`, `display.*`, `recording.*`.
91
+
92
+ Common iOS targets: `input.*`, `apps.*`, `environment.*`, `screenshot.*`, `recording.*`.
93
+
94
+ Docs: https://api.use.computer/docs
95
+
96
+ OpenAPI: https://api.use.computer/openapi.yaml
97
+
98
+ Runner: https://github.com/josancamon19/mmini-runner
@@ -0,0 +1,76 @@
1
+ # use-computer Python SDK
2
+
3
+ Python client for use.computer macOS and iOS sandboxes.
4
+
5
+ ```bash
6
+ pip install use-computer
7
+ export USE_COMPUTER_API_KEY=mk_live_...
8
+ ```
9
+
10
+ ```python
11
+ from use_computer import Computer
12
+
13
+ computer = Computer()
14
+ sandbox = computer.create() # macOS
15
+
16
+ try:
17
+ png = sandbox.screenshot.take_full_screen()
18
+ sandbox.mouse.click(500, 400)
19
+ sandbox.keyboard.type("hello")
20
+ sandbox.exec_ssh("open -a TextEdit")
21
+ finally:
22
+ sandbox.close()
23
+ computer.close()
24
+ ```
25
+
26
+ ## iOS
27
+
28
+ ```python
29
+ from use_computer import Computer
30
+
31
+ computer = Computer()
32
+ ios = computer.create(type="ios")
33
+ try:
34
+ ios.apps.open_url("https://example.com")
35
+ ios.input.tap(200, 300)
36
+ ios.input.type_text("hello")
37
+ ios.environment.set_appearance("dark")
38
+ finally:
39
+ ios.close()
40
+ computer.close()
41
+ ```
42
+
43
+ ## Action DSL
44
+
45
+ Actions are dotted method calls plus args/kwargs. They are useful when a model emits tool-like steps. Given an open macOS `sandbox`:
46
+
47
+ ```python
48
+ from use_computer import Action, parse_pyautogui, parse_xdotool
49
+
50
+ actions = [
51
+ Action("mouse.move", [500, 400]),
52
+ Action("mouse.click", [500, 400]),
53
+ Action("keyboard.hotkey", ["command+space"]),
54
+ Action("keyboard.type", ["Safari"]),
55
+ Action("screenshot.take_full_screen"),
56
+ ]
57
+
58
+ for action in actions:
59
+ action.execute(sandbox)
60
+
61
+ for action in parse_pyautogui("pyautogui.click(100, 200); pyautogui.write('hi')"):
62
+ action.execute(sandbox)
63
+
64
+ for action in parse_xdotool("xdotool mousemove 100 200 click 1 type hello"):
65
+ action.execute(sandbox)
66
+ ```
67
+
68
+ Common macOS targets: `mouse.*`, `keyboard.*`, `screenshot.*`, `display.*`, `recording.*`.
69
+
70
+ Common iOS targets: `input.*`, `apps.*`, `environment.*`, `screenshot.*`, `recording.*`.
71
+
72
+ Docs: https://api.use.computer/docs
73
+
74
+ OpenAPI: https://api.use.computer/openapi.yaml
75
+
76
+ Runner: https://github.com/josancamon19/mmini-runner
@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
4
4
 
5
5
  [project]
6
6
  name = "use-computer"
7
- version = "0.0.2"
7
+ version = "0.0.3"
8
8
  description = "Python SDK for the use.computer macOS and iOS Computer Use API"
9
9
  readme = "README.md"
10
10
  requires-python = ">=3.10"
@@ -34,7 +34,7 @@ dev = [
34
34
 
35
35
  [project.urls]
36
36
  Homepage = "https://use.computer"
37
- Documentation = "https://docs.use.computer"
37
+ Documentation = "https://api.use.computer/docs"
38
38
  Repository = "https://github.com/josancamon19/use-computer-python"
39
39
 
40
40
  [tool.hatch.build.targets.wheel]
@@ -1,49 +0,0 @@
1
- Metadata-Version: 2.4
2
- Name: use-computer
3
- Version: 0.0.2
4
- Summary: Python SDK for the use.computer macOS and iOS Computer Use API
5
- Project-URL: Homepage, https://use.computer
6
- Project-URL: Documentation, https://docs.use.computer
7
- Project-URL: Repository, https://github.com/josancamon19/use-computer-python
8
- Author: use.computer
9
- Keywords: automation,computer-use,ios,macos,sandbox
10
- Classifier: Development Status :: 3 - Alpha
11
- Classifier: Intended Audience :: Developers
12
- Classifier: Operating System :: OS Independent
13
- Classifier: Programming Language :: Python :: 3
14
- Classifier: Programming Language :: Python :: 3.10
15
- Classifier: Programming Language :: Python :: 3.11
16
- Classifier: Programming Language :: Python :: 3.12
17
- Classifier: Programming Language :: Python :: 3.13
18
- Classifier: Typing :: Typed
19
- Requires-Python: >=3.10
20
- Requires-Dist: httpx>=0.27
21
- Description-Content-Type: text/markdown
22
-
23
- # use-computer Python SDK
24
-
25
- Python client for the use.computer macOS and iOS Computer Use API.
26
-
27
- ```bash
28
- pip install use-computer
29
- ```
30
-
31
- ```python
32
- from use_computer import Computer
33
-
34
- computer = Computer(api_key="mk_live_...")
35
- sandbox = computer.create()
36
-
37
- image = sandbox.screenshot.take_full_screen()
38
- sandbox.mouse.click(500, 400)
39
- sandbox.keyboard.type("hello")
40
-
41
- sandbox.close()
42
- computer.close()
43
- ```
44
-
45
- Docs: https://docs.use.computer
46
-
47
- Runner repo: https://github.com/josancamon19/mmini-runner
48
-
49
- API reference: https://admin.api.use.computer/docs
@@ -1,27 +0,0 @@
1
- # use-computer Python SDK
2
-
3
- Python client for the use.computer macOS and iOS Computer Use API.
4
-
5
- ```bash
6
- pip install use-computer
7
- ```
8
-
9
- ```python
10
- from use_computer import Computer
11
-
12
- computer = Computer(api_key="mk_live_...")
13
- sandbox = computer.create()
14
-
15
- image = sandbox.screenshot.take_full_screen()
16
- sandbox.mouse.click(500, 400)
17
- sandbox.keyboard.type("hello")
18
-
19
- sandbox.close()
20
- computer.close()
21
- ```
22
-
23
- Docs: https://docs.use.computer
24
-
25
- Runner repo: https://github.com/josancamon19/mmini-runner
26
-
27
- API reference: https://admin.api.use.computer/docs
File without changes
File without changes
File without changes