simpleaible 1.2.1.dev106__tar.gz → 1.2.1.dev115__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.
- simpleaible-1.2.1.dev115/PKG-INFO +152 -0
- simpleaible-1.2.1.dev115/README.md +124 -0
- {simpleaible-1.2.1.dev106 → simpleaible-1.2.1.dev115}/pyproject.toml +3 -3
- simpleaible-1.2.1.dev115/src/simpleaible.egg-info/PKG-INFO +152 -0
- {simpleaible-1.2.1.dev106 → simpleaible-1.2.1.dev115}/src/simpleaible.egg-info/SOURCES.txt +1 -1
- simpleaible-1.2.1.dev106/PKG-INFO +0 -144
- simpleaible-1.2.1.dev106/README.rst +0 -116
- simpleaible-1.2.1.dev106/src/simpleaible.egg-info/PKG-INFO +0 -144
- {simpleaible-1.2.1.dev106 → simpleaible-1.2.1.dev115}/LICENSE.md +0 -0
- {simpleaible-1.2.1.dev106 → simpleaible-1.2.1.dev115}/setup.cfg +0 -0
- {simpleaible-1.2.1.dev106 → simpleaible-1.2.1.dev115}/src/simpleaible/__init__.py +0 -0
- {simpleaible-1.2.1.dev106 → simpleaible-1.2.1.dev115}/src/simpleaible/cli.py +0 -0
- {simpleaible-1.2.1.dev106 → simpleaible-1.2.1.dev115}/src/simpleaible/http.py +0 -0
- {simpleaible-1.2.1.dev106 → simpleaible-1.2.1.dev115}/src/simpleaible/mcp.py +0 -0
- {simpleaible-1.2.1.dev106 → simpleaible-1.2.1.dev115}/src/simpleaible/py.typed +0 -0
- {simpleaible-1.2.1.dev106 → simpleaible-1.2.1.dev115}/src/simpleaible/skills/simpleaible/SKILL.md +0 -0
- {simpleaible-1.2.1.dev106 → simpleaible-1.2.1.dev115}/src/simpleaible/skills/simpleaible/references/REFERENCE.md +0 -0
- {simpleaible-1.2.1.dev106 → simpleaible-1.2.1.dev115}/src/simpleaible/skills/simpleaible/references/examples.md +0 -0
- {simpleaible-1.2.1.dev106 → simpleaible-1.2.1.dev115}/src/simpleaible/skills/simpleaible/references/troubleshooting.md +0 -0
- {simpleaible-1.2.1.dev106 → simpleaible-1.2.1.dev115}/src/simpleaible.egg-info/dependency_links.txt +0 -0
- {simpleaible-1.2.1.dev106 → simpleaible-1.2.1.dev115}/src/simpleaible.egg-info/entry_points.txt +0 -0
- {simpleaible-1.2.1.dev106 → simpleaible-1.2.1.dev115}/src/simpleaible.egg-info/requires.txt +0 -0
- {simpleaible-1.2.1.dev106 → simpleaible-1.2.1.dev115}/src/simpleaible.egg-info/top_level.txt +0 -0
|
@@ -0,0 +1,152 @@
|
|
|
1
|
+
Metadata-Version: 2.4
|
|
2
|
+
Name: simpleaible
|
|
3
|
+
Version: 1.2.1.dev115
|
|
4
|
+
Summary: An MCP server, HTTP API, and agent skills that let AI agents use Bluetooth Low Energy devices through SimpleBLE. Free for non-commercial use; commercial use requires a license.
|
|
5
|
+
Author-email: Kevin Dewald <kevin@simpleble.org>
|
|
6
|
+
License-Expression: BUSL-1.1
|
|
7
|
+
Project-URL: Homepage, https://github.com/simpleble/simpleble
|
|
8
|
+
Keywords: ble,bluetooth,mcp,ai,simpleble
|
|
9
|
+
Classifier: Operating System :: Microsoft :: Windows
|
|
10
|
+
Classifier: Operating System :: MacOS
|
|
11
|
+
Classifier: Operating System :: POSIX :: Linux
|
|
12
|
+
Classifier: Programming Language :: Python :: 3
|
|
13
|
+
Classifier: Programming Language :: Python :: 3.10
|
|
14
|
+
Classifier: Programming Language :: Python :: 3.11
|
|
15
|
+
Classifier: Programming Language :: Python :: 3.12
|
|
16
|
+
Classifier: Programming Language :: Python :: 3.13
|
|
17
|
+
Classifier: Programming Language :: Python :: 3.14
|
|
18
|
+
Classifier: Programming Language :: Python :: 3 :: Only
|
|
19
|
+
Requires-Python: >=3.10
|
|
20
|
+
Description-Content-Type: text/markdown
|
|
21
|
+
License-File: LICENSE.md
|
|
22
|
+
Requires-Dist: simplepyble
|
|
23
|
+
Requires-Dist: fastmcp
|
|
24
|
+
Requires-Dist: fastapi
|
|
25
|
+
Requires-Dist: uvicorn
|
|
26
|
+
Requires-Dist: pydantic
|
|
27
|
+
Dynamic: license-file
|
|
28
|
+
|
|
29
|
+
<p align="center">
|
|
30
|
+
<picture>
|
|
31
|
+
<source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/simpleble/simpleble/main/docs/public/simpleBLE-logo.png">
|
|
32
|
+
<img src="https://raw.githubusercontent.com/simpleble/simpleble/main/docs/public/simpleBLE-logo-dark.png" alt="SimpleBLE" width="360">
|
|
33
|
+
</picture>
|
|
34
|
+
</p>
|
|
35
|
+
|
|
36
|
+
# SimpleAIBLE
|
|
37
|
+
|
|
38
|
+
**Build Bluetooth once. Ship it everywhere.**
|
|
39
|
+
|
|
40
|
+
SimpleAIBLE brings [SimpleBLE](https://github.com/simpleble/simpleble) to AI
|
|
41
|
+
agents on Windows, macOS, and Linux. Your agent scans for Bluetooth Low Energy
|
|
42
|
+
devices, connects, explores their services, reads and writes GATT values, and
|
|
43
|
+
follows notifications, through an MCP server, an HTTP API, or a bundled agent
|
|
44
|
+
skill.
|
|
45
|
+
|
|
46
|
+
## Why SimpleAIBLE
|
|
47
|
+
|
|
48
|
+
- **Works with your agent:** Use it from Claude Code, Codex, Cursor, Windsurf, or any MCP client, or call the HTTP API from your own tools.
|
|
49
|
+
- **Native underneath:** Use WinRT, CoreBluetooth, and BlueZ through SimpleBLE's maintained stack.
|
|
50
|
+
- **Built for real hardware work:** Let an agent discover, debug, and exercise the BLE devices on your desk.
|
|
51
|
+
- **Commercially supported:** Ship proprietary applications with commercial licensing and direct technical support from the team that builds SimpleBLE.
|
|
52
|
+
|
|
53
|
+
## Support and resources
|
|
54
|
+
|
|
55
|
+
- **Documentation:** The [MCP server](https://docs.simpleble.org/simpleaible/mcp?utm_source=pypi_simpleaible&utm_medium=referral&utm_campaign=simpleaible_readme&utm_content=support), [HTTP API](https://docs.simpleble.org/simpleaible/http?utm_source=pypi_simpleaible&utm_medium=referral&utm_campaign=simpleaible_readme&utm_content=support), and [agent skills](https://docs.simpleble.org/simpleaible/skills?utm_source=pypi_simpleaible&utm_medium=referral&utm_campaign=simpleaible_readme&utm_content=support) guides and the [tutorial](https://docs.simpleble.org/simpleaible/tutorial?utm_source=pypi_simpleaible&utm_medium=referral&utm_campaign=simpleaible_readme&utm_content=support) cover every tool.
|
|
56
|
+
- **Commercial support:** Visit [simpleble.org](https://simpleble.org?utm_source=pypi_simpleaible&utm_medium=referral&utm_campaign=simpleaible_readme&utm_content=support) or [email us](mailto:contact@simpleble.org) about licensing and professional services.
|
|
57
|
+
- **Community:** Ask questions and share projects in [GitHub Discussions](https://github.com/simpleble/simpleble/discussions).
|
|
58
|
+
- **Dongl:** Prototype and ship with the [official SimpleBLE USB adapter](https://www.simpleble.org/dongl?utm_source=pypi_simpleaible&utm_medium=referral&utm_campaign=simpleaible_readme&utm_content=support).
|
|
59
|
+
- **Contribute:** Send changes to [simpleble/simpleble](https://github.com/simpleble/simpleble/tree/main/simpleaible).
|
|
60
|
+
|
|
61
|
+
## Get started
|
|
62
|
+
|
|
63
|
+
Use Python 3.10 or newer, and install SimpleAIBLE with [uv](https://docs.astral.sh/uv/):
|
|
64
|
+
|
|
65
|
+
```sh
|
|
66
|
+
uv tool install simpleaible
|
|
67
|
+
```
|
|
68
|
+
|
|
69
|
+
`pip install simpleaible` works too. Then register the MCP server with your
|
|
70
|
+
agent. For Claude Code:
|
|
71
|
+
|
|
72
|
+
```sh
|
|
73
|
+
claude mcp add simpleaible -- simpleaible
|
|
74
|
+
```
|
|
75
|
+
|
|
76
|
+
Other MCP clients take the same command, `simpleaible`, in their configuration.
|
|
77
|
+
Ask your agent to scan for five seconds and list what it found.
|
|
78
|
+
|
|
79
|
+
## MCP server
|
|
80
|
+
|
|
81
|
+
`simpleaible` starts the MCP server over stdio. Its tools cover the whole
|
|
82
|
+
client workflow: `get_adapters`, `scan_for`, `connect`, `services`, `read`,
|
|
83
|
+
`write_request`, `write_command`, `notify`, `indicate`, `get_notifications`,
|
|
84
|
+
`unsubscribe`, and `disconnect`. The
|
|
85
|
+
[MCP server guide](https://docs.simpleble.org/simpleaible/mcp?utm_source=pypi_simpleaible&utm_medium=referral&utm_campaign=simpleaible_readme&utm_content=mcp)
|
|
86
|
+
has the configuration for each client.
|
|
87
|
+
|
|
88
|
+
## HTTP API
|
|
89
|
+
|
|
90
|
+
Run the HTTP server to control BLE devices from your own tools:
|
|
91
|
+
|
|
92
|
+
```sh
|
|
93
|
+
simpleaible-http --host 127.0.0.1 --port 8000
|
|
94
|
+
```
|
|
95
|
+
|
|
96
|
+
The API mirrors the MCP tools: `GET /adapters`, `POST /scan`,
|
|
97
|
+
`POST /connect/{address}`, and reads, writes, and subscriptions under
|
|
98
|
+
`/device/{address}`. The
|
|
99
|
+
[HTTP API reference](https://docs.simpleble.org/simpleaible/http?utm_source=pypi_simpleaible&utm_medium=referral&utm_campaign=simpleaible_readme&utm_content=http)
|
|
100
|
+
lists every endpoint.
|
|
101
|
+
|
|
102
|
+
## Agent skills
|
|
103
|
+
|
|
104
|
+
Install the SimpleAIBLE skill so your agent knows the BLE workflows, platform
|
|
105
|
+
differences, and debugging patterns:
|
|
106
|
+
|
|
107
|
+
```sh
|
|
108
|
+
simpleaible install
|
|
109
|
+
```
|
|
110
|
+
|
|
111
|
+
The installer finds Claude Code and Codex and adds the skill to each, and
|
|
112
|
+
`simpleaible uninstall` removes it. For other agents, use the `skills` CLI:
|
|
113
|
+
|
|
114
|
+
```sh
|
|
115
|
+
npx skills add https://github.com/simpleble/simpleble --skill simpleaible
|
|
116
|
+
```
|
|
117
|
+
|
|
118
|
+
## Platforms
|
|
119
|
+
|
|
120
|
+
| Platform | Architectures | Requirements |
|
|
121
|
+
| --- | --- | --- |
|
|
122
|
+
| macOS 15.0 or newer | x64, arm64 | Bluetooth permission for the app that runs your agent |
|
|
123
|
+
| Windows 10 or newer | x64, x86, arm64 | |
|
|
124
|
+
| Linux | x64, x86, arm64 | BlueZ and the D-Bus library |
|
|
125
|
+
|
|
126
|
+
See [Bluetooth permissions](https://docs.simpleble.org/fundamentals/permissions?utm_source=pypi_simpleaible&utm_medium=referral&utm_campaign=simpleaible_readme&utm_content=platforms)
|
|
127
|
+
for the setup each platform needs.
|
|
128
|
+
|
|
129
|
+
## Versions
|
|
130
|
+
|
|
131
|
+
SimpleAIBLE follows SimpleBLE's release versions. uv and pip install the latest
|
|
132
|
+
stable release, and development builds of the main branch are published as
|
|
133
|
+
pre-releases:
|
|
134
|
+
|
|
135
|
+
```sh
|
|
136
|
+
uv tool install --prerelease allow simpleaible
|
|
137
|
+
```
|
|
138
|
+
|
|
139
|
+
## License
|
|
140
|
+
|
|
141
|
+
SimpleAIBLE follows the [SimpleBLE license](https://github.com/simpleble/simpleble/blob/main/LICENSE.md),
|
|
142
|
+
the Business Source License 1.1 (BUSL-1.1). It is free for non-commercial use,
|
|
143
|
+
and commercial use needs a commercial license. We offer free commercial licenses
|
|
144
|
+
for small projects and early-stage companies: [email us](mailto:contact@simpleble.org)
|
|
145
|
+
or [leave us a message](https://www.simpleble.org/contact?utm_source=pypi_simpleaible&utm_medium=referral&utm_campaign=simpleaible_readme&utm_content=license)
|
|
146
|
+
to discuss your use case. Commercial licenses carry no royalties or revenue
|
|
147
|
+
sharing; see the [licensing page](https://docs.simpleble.org/licensing?utm_source=pypi_simpleaible&utm_medium=referral&utm_campaign=simpleaible_readme&utm_content=license)
|
|
148
|
+
for terms.
|
|
149
|
+
|
|
150
|
+
---
|
|
151
|
+
|
|
152
|
+
**SimpleBLE** is a project powered by [The California Open Source Company](https://californiaopensource.com?utm_source=pypi_simpleaible&utm_medium=referral&utm_campaign=simpleaible_readme&utm_content=footer).
|
|
@@ -0,0 +1,124 @@
|
|
|
1
|
+
<p align="center">
|
|
2
|
+
<picture>
|
|
3
|
+
<source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/simpleble/simpleble/main/docs/public/simpleBLE-logo.png">
|
|
4
|
+
<img src="https://raw.githubusercontent.com/simpleble/simpleble/main/docs/public/simpleBLE-logo-dark.png" alt="SimpleBLE" width="360">
|
|
5
|
+
</picture>
|
|
6
|
+
</p>
|
|
7
|
+
|
|
8
|
+
# SimpleAIBLE
|
|
9
|
+
|
|
10
|
+
**Build Bluetooth once. Ship it everywhere.**
|
|
11
|
+
|
|
12
|
+
SimpleAIBLE brings [SimpleBLE](https://github.com/simpleble/simpleble) to AI
|
|
13
|
+
agents on Windows, macOS, and Linux. Your agent scans for Bluetooth Low Energy
|
|
14
|
+
devices, connects, explores their services, reads and writes GATT values, and
|
|
15
|
+
follows notifications, through an MCP server, an HTTP API, or a bundled agent
|
|
16
|
+
skill.
|
|
17
|
+
|
|
18
|
+
## Why SimpleAIBLE
|
|
19
|
+
|
|
20
|
+
- **Works with your agent:** Use it from Claude Code, Codex, Cursor, Windsurf, or any MCP client, or call the HTTP API from your own tools.
|
|
21
|
+
- **Native underneath:** Use WinRT, CoreBluetooth, and BlueZ through SimpleBLE's maintained stack.
|
|
22
|
+
- **Built for real hardware work:** Let an agent discover, debug, and exercise the BLE devices on your desk.
|
|
23
|
+
- **Commercially supported:** Ship proprietary applications with commercial licensing and direct technical support from the team that builds SimpleBLE.
|
|
24
|
+
|
|
25
|
+
## Support and resources
|
|
26
|
+
|
|
27
|
+
- **Documentation:** The [MCP server](https://docs.simpleble.org/simpleaible/mcp?utm_source=pypi_simpleaible&utm_medium=referral&utm_campaign=simpleaible_readme&utm_content=support), [HTTP API](https://docs.simpleble.org/simpleaible/http?utm_source=pypi_simpleaible&utm_medium=referral&utm_campaign=simpleaible_readme&utm_content=support), and [agent skills](https://docs.simpleble.org/simpleaible/skills?utm_source=pypi_simpleaible&utm_medium=referral&utm_campaign=simpleaible_readme&utm_content=support) guides and the [tutorial](https://docs.simpleble.org/simpleaible/tutorial?utm_source=pypi_simpleaible&utm_medium=referral&utm_campaign=simpleaible_readme&utm_content=support) cover every tool.
|
|
28
|
+
- **Commercial support:** Visit [simpleble.org](https://simpleble.org?utm_source=pypi_simpleaible&utm_medium=referral&utm_campaign=simpleaible_readme&utm_content=support) or [email us](mailto:contact@simpleble.org) about licensing and professional services.
|
|
29
|
+
- **Community:** Ask questions and share projects in [GitHub Discussions](https://github.com/simpleble/simpleble/discussions).
|
|
30
|
+
- **Dongl:** Prototype and ship with the [official SimpleBLE USB adapter](https://www.simpleble.org/dongl?utm_source=pypi_simpleaible&utm_medium=referral&utm_campaign=simpleaible_readme&utm_content=support).
|
|
31
|
+
- **Contribute:** Send changes to [simpleble/simpleble](https://github.com/simpleble/simpleble/tree/main/simpleaible).
|
|
32
|
+
|
|
33
|
+
## Get started
|
|
34
|
+
|
|
35
|
+
Use Python 3.10 or newer, and install SimpleAIBLE with [uv](https://docs.astral.sh/uv/):
|
|
36
|
+
|
|
37
|
+
```sh
|
|
38
|
+
uv tool install simpleaible
|
|
39
|
+
```
|
|
40
|
+
|
|
41
|
+
`pip install simpleaible` works too. Then register the MCP server with your
|
|
42
|
+
agent. For Claude Code:
|
|
43
|
+
|
|
44
|
+
```sh
|
|
45
|
+
claude mcp add simpleaible -- simpleaible
|
|
46
|
+
```
|
|
47
|
+
|
|
48
|
+
Other MCP clients take the same command, `simpleaible`, in their configuration.
|
|
49
|
+
Ask your agent to scan for five seconds and list what it found.
|
|
50
|
+
|
|
51
|
+
## MCP server
|
|
52
|
+
|
|
53
|
+
`simpleaible` starts the MCP server over stdio. Its tools cover the whole
|
|
54
|
+
client workflow: `get_adapters`, `scan_for`, `connect`, `services`, `read`,
|
|
55
|
+
`write_request`, `write_command`, `notify`, `indicate`, `get_notifications`,
|
|
56
|
+
`unsubscribe`, and `disconnect`. The
|
|
57
|
+
[MCP server guide](https://docs.simpleble.org/simpleaible/mcp?utm_source=pypi_simpleaible&utm_medium=referral&utm_campaign=simpleaible_readme&utm_content=mcp)
|
|
58
|
+
has the configuration for each client.
|
|
59
|
+
|
|
60
|
+
## HTTP API
|
|
61
|
+
|
|
62
|
+
Run the HTTP server to control BLE devices from your own tools:
|
|
63
|
+
|
|
64
|
+
```sh
|
|
65
|
+
simpleaible-http --host 127.0.0.1 --port 8000
|
|
66
|
+
```
|
|
67
|
+
|
|
68
|
+
The API mirrors the MCP tools: `GET /adapters`, `POST /scan`,
|
|
69
|
+
`POST /connect/{address}`, and reads, writes, and subscriptions under
|
|
70
|
+
`/device/{address}`. The
|
|
71
|
+
[HTTP API reference](https://docs.simpleble.org/simpleaible/http?utm_source=pypi_simpleaible&utm_medium=referral&utm_campaign=simpleaible_readme&utm_content=http)
|
|
72
|
+
lists every endpoint.
|
|
73
|
+
|
|
74
|
+
## Agent skills
|
|
75
|
+
|
|
76
|
+
Install the SimpleAIBLE skill so your agent knows the BLE workflows, platform
|
|
77
|
+
differences, and debugging patterns:
|
|
78
|
+
|
|
79
|
+
```sh
|
|
80
|
+
simpleaible install
|
|
81
|
+
```
|
|
82
|
+
|
|
83
|
+
The installer finds Claude Code and Codex and adds the skill to each, and
|
|
84
|
+
`simpleaible uninstall` removes it. For other agents, use the `skills` CLI:
|
|
85
|
+
|
|
86
|
+
```sh
|
|
87
|
+
npx skills add https://github.com/simpleble/simpleble --skill simpleaible
|
|
88
|
+
```
|
|
89
|
+
|
|
90
|
+
## Platforms
|
|
91
|
+
|
|
92
|
+
| Platform | Architectures | Requirements |
|
|
93
|
+
| --- | --- | --- |
|
|
94
|
+
| macOS 15.0 or newer | x64, arm64 | Bluetooth permission for the app that runs your agent |
|
|
95
|
+
| Windows 10 or newer | x64, x86, arm64 | |
|
|
96
|
+
| Linux | x64, x86, arm64 | BlueZ and the D-Bus library |
|
|
97
|
+
|
|
98
|
+
See [Bluetooth permissions](https://docs.simpleble.org/fundamentals/permissions?utm_source=pypi_simpleaible&utm_medium=referral&utm_campaign=simpleaible_readme&utm_content=platforms)
|
|
99
|
+
for the setup each platform needs.
|
|
100
|
+
|
|
101
|
+
## Versions
|
|
102
|
+
|
|
103
|
+
SimpleAIBLE follows SimpleBLE's release versions. uv and pip install the latest
|
|
104
|
+
stable release, and development builds of the main branch are published as
|
|
105
|
+
pre-releases:
|
|
106
|
+
|
|
107
|
+
```sh
|
|
108
|
+
uv tool install --prerelease allow simpleaible
|
|
109
|
+
```
|
|
110
|
+
|
|
111
|
+
## License
|
|
112
|
+
|
|
113
|
+
SimpleAIBLE follows the [SimpleBLE license](https://github.com/simpleble/simpleble/blob/main/LICENSE.md),
|
|
114
|
+
the Business Source License 1.1 (BUSL-1.1). It is free for non-commercial use,
|
|
115
|
+
and commercial use needs a commercial license. We offer free commercial licenses
|
|
116
|
+
for small projects and early-stage companies: [email us](mailto:contact@simpleble.org)
|
|
117
|
+
or [leave us a message](https://www.simpleble.org/contact?utm_source=pypi_simpleaible&utm_medium=referral&utm_campaign=simpleaible_readme&utm_content=license)
|
|
118
|
+
to discuss your use case. Commercial licenses carry no royalties or revenue
|
|
119
|
+
sharing; see the [licensing page](https://docs.simpleble.org/licensing?utm_source=pypi_simpleaible&utm_medium=referral&utm_campaign=simpleaible_readme&utm_content=license)
|
|
120
|
+
for terms.
|
|
121
|
+
|
|
122
|
+
---
|
|
123
|
+
|
|
124
|
+
**SimpleBLE** is a project powered by [The California Open Source Company](https://californiaopensource.com?utm_source=pypi_simpleaible&utm_medium=referral&utm_campaign=simpleaible_readme&utm_content=footer).
|
|
@@ -4,9 +4,9 @@ build-backend = "setuptools.build_meta"
|
|
|
4
4
|
|
|
5
5
|
[project]
|
|
6
6
|
name = "simpleaible"
|
|
7
|
-
version = "1.2.1-
|
|
8
|
-
description = "
|
|
9
|
-
readme = "README.
|
|
7
|
+
version = "1.2.1-dev115"
|
|
8
|
+
description = "An MCP server, HTTP API, and agent skills that let AI agents use Bluetooth Low Energy devices through SimpleBLE. Free for non-commercial use; commercial use requires a license."
|
|
9
|
+
readme = "README.md"
|
|
10
10
|
license = "BUSL-1.1"
|
|
11
11
|
requires-python = ">=3.10"
|
|
12
12
|
authors = [{ name = "Kevin Dewald", email = "kevin@simpleble.org" }]
|
|
@@ -0,0 +1,152 @@
|
|
|
1
|
+
Metadata-Version: 2.4
|
|
2
|
+
Name: simpleaible
|
|
3
|
+
Version: 1.2.1.dev115
|
|
4
|
+
Summary: An MCP server, HTTP API, and agent skills that let AI agents use Bluetooth Low Energy devices through SimpleBLE. Free for non-commercial use; commercial use requires a license.
|
|
5
|
+
Author-email: Kevin Dewald <kevin@simpleble.org>
|
|
6
|
+
License-Expression: BUSL-1.1
|
|
7
|
+
Project-URL: Homepage, https://github.com/simpleble/simpleble
|
|
8
|
+
Keywords: ble,bluetooth,mcp,ai,simpleble
|
|
9
|
+
Classifier: Operating System :: Microsoft :: Windows
|
|
10
|
+
Classifier: Operating System :: MacOS
|
|
11
|
+
Classifier: Operating System :: POSIX :: Linux
|
|
12
|
+
Classifier: Programming Language :: Python :: 3
|
|
13
|
+
Classifier: Programming Language :: Python :: 3.10
|
|
14
|
+
Classifier: Programming Language :: Python :: 3.11
|
|
15
|
+
Classifier: Programming Language :: Python :: 3.12
|
|
16
|
+
Classifier: Programming Language :: Python :: 3.13
|
|
17
|
+
Classifier: Programming Language :: Python :: 3.14
|
|
18
|
+
Classifier: Programming Language :: Python :: 3 :: Only
|
|
19
|
+
Requires-Python: >=3.10
|
|
20
|
+
Description-Content-Type: text/markdown
|
|
21
|
+
License-File: LICENSE.md
|
|
22
|
+
Requires-Dist: simplepyble
|
|
23
|
+
Requires-Dist: fastmcp
|
|
24
|
+
Requires-Dist: fastapi
|
|
25
|
+
Requires-Dist: uvicorn
|
|
26
|
+
Requires-Dist: pydantic
|
|
27
|
+
Dynamic: license-file
|
|
28
|
+
|
|
29
|
+
<p align="center">
|
|
30
|
+
<picture>
|
|
31
|
+
<source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/simpleble/simpleble/main/docs/public/simpleBLE-logo.png">
|
|
32
|
+
<img src="https://raw.githubusercontent.com/simpleble/simpleble/main/docs/public/simpleBLE-logo-dark.png" alt="SimpleBLE" width="360">
|
|
33
|
+
</picture>
|
|
34
|
+
</p>
|
|
35
|
+
|
|
36
|
+
# SimpleAIBLE
|
|
37
|
+
|
|
38
|
+
**Build Bluetooth once. Ship it everywhere.**
|
|
39
|
+
|
|
40
|
+
SimpleAIBLE brings [SimpleBLE](https://github.com/simpleble/simpleble) to AI
|
|
41
|
+
agents on Windows, macOS, and Linux. Your agent scans for Bluetooth Low Energy
|
|
42
|
+
devices, connects, explores their services, reads and writes GATT values, and
|
|
43
|
+
follows notifications, through an MCP server, an HTTP API, or a bundled agent
|
|
44
|
+
skill.
|
|
45
|
+
|
|
46
|
+
## Why SimpleAIBLE
|
|
47
|
+
|
|
48
|
+
- **Works with your agent:** Use it from Claude Code, Codex, Cursor, Windsurf, or any MCP client, or call the HTTP API from your own tools.
|
|
49
|
+
- **Native underneath:** Use WinRT, CoreBluetooth, and BlueZ through SimpleBLE's maintained stack.
|
|
50
|
+
- **Built for real hardware work:** Let an agent discover, debug, and exercise the BLE devices on your desk.
|
|
51
|
+
- **Commercially supported:** Ship proprietary applications with commercial licensing and direct technical support from the team that builds SimpleBLE.
|
|
52
|
+
|
|
53
|
+
## Support and resources
|
|
54
|
+
|
|
55
|
+
- **Documentation:** The [MCP server](https://docs.simpleble.org/simpleaible/mcp?utm_source=pypi_simpleaible&utm_medium=referral&utm_campaign=simpleaible_readme&utm_content=support), [HTTP API](https://docs.simpleble.org/simpleaible/http?utm_source=pypi_simpleaible&utm_medium=referral&utm_campaign=simpleaible_readme&utm_content=support), and [agent skills](https://docs.simpleble.org/simpleaible/skills?utm_source=pypi_simpleaible&utm_medium=referral&utm_campaign=simpleaible_readme&utm_content=support) guides and the [tutorial](https://docs.simpleble.org/simpleaible/tutorial?utm_source=pypi_simpleaible&utm_medium=referral&utm_campaign=simpleaible_readme&utm_content=support) cover every tool.
|
|
56
|
+
- **Commercial support:** Visit [simpleble.org](https://simpleble.org?utm_source=pypi_simpleaible&utm_medium=referral&utm_campaign=simpleaible_readme&utm_content=support) or [email us](mailto:contact@simpleble.org) about licensing and professional services.
|
|
57
|
+
- **Community:** Ask questions and share projects in [GitHub Discussions](https://github.com/simpleble/simpleble/discussions).
|
|
58
|
+
- **Dongl:** Prototype and ship with the [official SimpleBLE USB adapter](https://www.simpleble.org/dongl?utm_source=pypi_simpleaible&utm_medium=referral&utm_campaign=simpleaible_readme&utm_content=support).
|
|
59
|
+
- **Contribute:** Send changes to [simpleble/simpleble](https://github.com/simpleble/simpleble/tree/main/simpleaible).
|
|
60
|
+
|
|
61
|
+
## Get started
|
|
62
|
+
|
|
63
|
+
Use Python 3.10 or newer, and install SimpleAIBLE with [uv](https://docs.astral.sh/uv/):
|
|
64
|
+
|
|
65
|
+
```sh
|
|
66
|
+
uv tool install simpleaible
|
|
67
|
+
```
|
|
68
|
+
|
|
69
|
+
`pip install simpleaible` works too. Then register the MCP server with your
|
|
70
|
+
agent. For Claude Code:
|
|
71
|
+
|
|
72
|
+
```sh
|
|
73
|
+
claude mcp add simpleaible -- simpleaible
|
|
74
|
+
```
|
|
75
|
+
|
|
76
|
+
Other MCP clients take the same command, `simpleaible`, in their configuration.
|
|
77
|
+
Ask your agent to scan for five seconds and list what it found.
|
|
78
|
+
|
|
79
|
+
## MCP server
|
|
80
|
+
|
|
81
|
+
`simpleaible` starts the MCP server over stdio. Its tools cover the whole
|
|
82
|
+
client workflow: `get_adapters`, `scan_for`, `connect`, `services`, `read`,
|
|
83
|
+
`write_request`, `write_command`, `notify`, `indicate`, `get_notifications`,
|
|
84
|
+
`unsubscribe`, and `disconnect`. The
|
|
85
|
+
[MCP server guide](https://docs.simpleble.org/simpleaible/mcp?utm_source=pypi_simpleaible&utm_medium=referral&utm_campaign=simpleaible_readme&utm_content=mcp)
|
|
86
|
+
has the configuration for each client.
|
|
87
|
+
|
|
88
|
+
## HTTP API
|
|
89
|
+
|
|
90
|
+
Run the HTTP server to control BLE devices from your own tools:
|
|
91
|
+
|
|
92
|
+
```sh
|
|
93
|
+
simpleaible-http --host 127.0.0.1 --port 8000
|
|
94
|
+
```
|
|
95
|
+
|
|
96
|
+
The API mirrors the MCP tools: `GET /adapters`, `POST /scan`,
|
|
97
|
+
`POST /connect/{address}`, and reads, writes, and subscriptions under
|
|
98
|
+
`/device/{address}`. The
|
|
99
|
+
[HTTP API reference](https://docs.simpleble.org/simpleaible/http?utm_source=pypi_simpleaible&utm_medium=referral&utm_campaign=simpleaible_readme&utm_content=http)
|
|
100
|
+
lists every endpoint.
|
|
101
|
+
|
|
102
|
+
## Agent skills
|
|
103
|
+
|
|
104
|
+
Install the SimpleAIBLE skill so your agent knows the BLE workflows, platform
|
|
105
|
+
differences, and debugging patterns:
|
|
106
|
+
|
|
107
|
+
```sh
|
|
108
|
+
simpleaible install
|
|
109
|
+
```
|
|
110
|
+
|
|
111
|
+
The installer finds Claude Code and Codex and adds the skill to each, and
|
|
112
|
+
`simpleaible uninstall` removes it. For other agents, use the `skills` CLI:
|
|
113
|
+
|
|
114
|
+
```sh
|
|
115
|
+
npx skills add https://github.com/simpleble/simpleble --skill simpleaible
|
|
116
|
+
```
|
|
117
|
+
|
|
118
|
+
## Platforms
|
|
119
|
+
|
|
120
|
+
| Platform | Architectures | Requirements |
|
|
121
|
+
| --- | --- | --- |
|
|
122
|
+
| macOS 15.0 or newer | x64, arm64 | Bluetooth permission for the app that runs your agent |
|
|
123
|
+
| Windows 10 or newer | x64, x86, arm64 | |
|
|
124
|
+
| Linux | x64, x86, arm64 | BlueZ and the D-Bus library |
|
|
125
|
+
|
|
126
|
+
See [Bluetooth permissions](https://docs.simpleble.org/fundamentals/permissions?utm_source=pypi_simpleaible&utm_medium=referral&utm_campaign=simpleaible_readme&utm_content=platforms)
|
|
127
|
+
for the setup each platform needs.
|
|
128
|
+
|
|
129
|
+
## Versions
|
|
130
|
+
|
|
131
|
+
SimpleAIBLE follows SimpleBLE's release versions. uv and pip install the latest
|
|
132
|
+
stable release, and development builds of the main branch are published as
|
|
133
|
+
pre-releases:
|
|
134
|
+
|
|
135
|
+
```sh
|
|
136
|
+
uv tool install --prerelease allow simpleaible
|
|
137
|
+
```
|
|
138
|
+
|
|
139
|
+
## License
|
|
140
|
+
|
|
141
|
+
SimpleAIBLE follows the [SimpleBLE license](https://github.com/simpleble/simpleble/blob/main/LICENSE.md),
|
|
142
|
+
the Business Source License 1.1 (BUSL-1.1). It is free for non-commercial use,
|
|
143
|
+
and commercial use needs a commercial license. We offer free commercial licenses
|
|
144
|
+
for small projects and early-stage companies: [email us](mailto:contact@simpleble.org)
|
|
145
|
+
or [leave us a message](https://www.simpleble.org/contact?utm_source=pypi_simpleaible&utm_medium=referral&utm_campaign=simpleaible_readme&utm_content=license)
|
|
146
|
+
to discuss your use case. Commercial licenses carry no royalties or revenue
|
|
147
|
+
sharing; see the [licensing page](https://docs.simpleble.org/licensing?utm_source=pypi_simpleaible&utm_medium=referral&utm_campaign=simpleaible_readme&utm_content=license)
|
|
148
|
+
for terms.
|
|
149
|
+
|
|
150
|
+
---
|
|
151
|
+
|
|
152
|
+
**SimpleBLE** is a project powered by [The California Open Source Company](https://californiaopensource.com?utm_source=pypi_simpleaible&utm_medium=referral&utm_campaign=simpleaible_readme&utm_content=footer).
|
|
@@ -1,144 +0,0 @@
|
|
|
1
|
-
Metadata-Version: 2.4
|
|
2
|
-
Name: simpleaible
|
|
3
|
-
Version: 1.2.1.dev106
|
|
4
|
-
Summary: SimpleAIBLE is an AI-friendly BLE toolkit (MCP server & REST API) powered by SimplePyBLE. Free for non-commercial use; commercial use requires a license.
|
|
5
|
-
Author-email: Kevin Dewald <kevin@simpleble.org>
|
|
6
|
-
License-Expression: BUSL-1.1
|
|
7
|
-
Project-URL: Homepage, https://github.com/simpleble/simpleble
|
|
8
|
-
Keywords: ble,bluetooth,mcp,ai,simpleble
|
|
9
|
-
Classifier: Operating System :: Microsoft :: Windows
|
|
10
|
-
Classifier: Operating System :: MacOS
|
|
11
|
-
Classifier: Operating System :: POSIX :: Linux
|
|
12
|
-
Classifier: Programming Language :: Python :: 3
|
|
13
|
-
Classifier: Programming Language :: Python :: 3.10
|
|
14
|
-
Classifier: Programming Language :: Python :: 3.11
|
|
15
|
-
Classifier: Programming Language :: Python :: 3.12
|
|
16
|
-
Classifier: Programming Language :: Python :: 3.13
|
|
17
|
-
Classifier: Programming Language :: Python :: 3.14
|
|
18
|
-
Classifier: Programming Language :: Python :: 3 :: Only
|
|
19
|
-
Requires-Python: >=3.10
|
|
20
|
-
Description-Content-Type: text/x-rst
|
|
21
|
-
License-File: LICENSE.md
|
|
22
|
-
Requires-Dist: simplepyble
|
|
23
|
-
Requires-Dist: fastmcp
|
|
24
|
-
Requires-Dist: fastapi
|
|
25
|
-
Requires-Dist: uvicorn
|
|
26
|
-
Requires-Dist: pydantic
|
|
27
|
-
Dynamic: license-file
|
|
28
|
-
|
|
29
|
-
|PyPI Licence|
|
|
30
|
-
|
|
31
|
-
SimpleAIBLE
|
|
32
|
-
===========
|
|
33
|
-
|
|
34
|
-
An AI-friendly BLE toolkit powered by `SimpleBLE`_. Scan, connect, and interact with Bluetooth Low Energy devices from AI agents and scripts.
|
|
35
|
-
|
|
36
|
-
Key Features
|
|
37
|
-
------------
|
|
38
|
-
|
|
39
|
-
* **MCP Server**: Expose BLE operations as tools for MCP-capable clients (Cursor, Claude Code, Windsurf, etc.)
|
|
40
|
-
* **HTTP Server**: Control BLE devices over a REST API
|
|
41
|
-
* **Agent Skills**: Teach your AI assistant how to work with Bluetooth devices using reusable skill files
|
|
42
|
-
* **Cross-Platform**: Works on Windows, macOS, and Linux
|
|
43
|
-
|
|
44
|
-
Support & Resources
|
|
45
|
-
--------------------
|
|
46
|
-
|
|
47
|
-
We're here to help you succeed with SimpleAIBLE:
|
|
48
|
-
|
|
49
|
-
* **Documentation**: Visit our `docs`_ page for comprehensive guides
|
|
50
|
-
* **Commercial Support**: Check out |website|_ or |email|_ about licensing and professional services.
|
|
51
|
-
* **Community**: Ask questions and share projects in `GitHub Discussions`_
|
|
52
|
-
* **Dongl**: Pair AI-driven BLE workflows with the `official SimpleBLE Bluetooth dongle`_.
|
|
53
|
-
|
|
54
|
-
**Don't hesitate to reach out if you need assistance - we're happy to help!**
|
|
55
|
-
|
|
56
|
-
Installation
|
|
57
|
-
------------
|
|
58
|
-
|
|
59
|
-
Install SimpleAIBLE using your preferred package manager:
|
|
60
|
-
|
|
61
|
-
Using uv (recommended): ::
|
|
62
|
-
|
|
63
|
-
uv tool install simpleaible
|
|
64
|
-
|
|
65
|
-
Or using pip: ::
|
|
66
|
-
|
|
67
|
-
pip install simpleaible
|
|
68
|
-
|
|
69
|
-
MCP Server
|
|
70
|
-
----------
|
|
71
|
-
|
|
72
|
-
Expose BLE operations as tools for MCP-capable clients (Cursor, Claude Code, etc.).
|
|
73
|
-
Configure it in your MCP client with the following command: ``"command": "simpleaible-mcp"``.
|
|
74
|
-
|
|
75
|
-
See the `MCP Server docs`_ for full tool documentation and client-specific setup.
|
|
76
|
-
|
|
77
|
-
HTTP Server
|
|
78
|
-
-----------
|
|
79
|
-
|
|
80
|
-
Run the REST API for controlling BLE devices remotely: ::
|
|
81
|
-
|
|
82
|
-
simpleaible-http --host 127.0.0.1 --port 8000
|
|
83
|
-
|
|
84
|
-
See the `HTTP Server docs`_ for the full API reference.
|
|
85
|
-
|
|
86
|
-
Agent Skills
|
|
87
|
-
------------
|
|
88
|
-
|
|
89
|
-
Install the SimpleAIBLE skill to give your AI agent built-in knowledge of BLE workflows.
|
|
90
|
-
The bundled installer detects Claude Code and Codex automatically: ::
|
|
91
|
-
|
|
92
|
-
simpleaible install
|
|
93
|
-
|
|
94
|
-
Run ``simpleaible uninstall`` to remove the skill again. For other agents, use the ``skills`` CLI: ::
|
|
95
|
-
|
|
96
|
-
npx skills add https://github.com/simpleble/simpleble --skill simpleaible
|
|
97
|
-
|
|
98
|
-
See the `Agent Skills docs`_ for more details.
|
|
99
|
-
|
|
100
|
-
License
|
|
101
|
-
=======
|
|
102
|
-
|
|
103
|
-
SimpleAIBLE follows the `SimpleBLE license`_, the Business Source License 1.1 (BUSL-1.1). It is free for non-commercial
|
|
104
|
-
use, and commercial use needs a commercial license. We offer free commercial licenses for small projects and early-stage
|
|
105
|
-
companies: |email|_ or |leavemessage|_ to discuss your use case. Commercial licenses carry no royalties or revenue
|
|
106
|
-
sharing; see the `licensing page`_ for terms.
|
|
107
|
-
|
|
108
|
-
----
|
|
109
|
-
|
|
110
|
-
**SimpleAIBLE** is a project powered by |caos|_.
|
|
111
|
-
|
|
112
|
-
.. Links
|
|
113
|
-
|
|
114
|
-
.. |email| replace:: email us
|
|
115
|
-
.. _email: mailto:contact@simpleble.org
|
|
116
|
-
|
|
117
|
-
.. |leavemessage| replace:: leave us a message
|
|
118
|
-
.. _leavemessage: https://www.simpleble.org/contact?utm_source=pypi_simpleaible&utm_medium=referral&utm_campaign=simpleaible_readme&utm_content=license
|
|
119
|
-
|
|
120
|
-
.. |website| replace:: our website
|
|
121
|
-
.. _website: https://simpleble.org?utm_source=pypi_simpleaible&utm_medium=referral&utm_campaign=simpleaible_readme&utm_content=support
|
|
122
|
-
|
|
123
|
-
.. |caos| replace:: **The California Open Source Company**
|
|
124
|
-
.. _caos: https://californiaopensource.com?utm_source=pypi_simpleaible&utm_medium=referral&utm_campaign=simpleaible_readme&utm_content=footer
|
|
125
|
-
|
|
126
|
-
.. _SimpleBLE: https://github.com/simpleble/simpleble/
|
|
127
|
-
|
|
128
|
-
.. _SimpleBLE license: https://github.com/simpleble/simpleble/blob/main/LICENSE.md
|
|
129
|
-
|
|
130
|
-
.. _licensing page: https://docs.simpleble.org/licensing?utm_source=pypi_simpleaible&utm_medium=referral&utm_campaign=simpleaible_readme&utm_content=license
|
|
131
|
-
|
|
132
|
-
.. _official SimpleBLE Bluetooth dongle: https://www.simpleble.org/dongl?utm_source=pypi_simpleaible&utm_medium=referral&utm_campaign=simpleaible_readme&utm_content=support
|
|
133
|
-
|
|
134
|
-
.. _docs: https://docs.simpleble.org/?utm_source=pypi_simpleaible&utm_medium=referral&utm_campaign=simpleaible_readme&utm_content=support
|
|
135
|
-
|
|
136
|
-
.. _GitHub Discussions: https://github.com/simpleble/simpleble/discussions
|
|
137
|
-
|
|
138
|
-
.. _MCP Server docs: https://docs.simpleble.org/simpleaible/mcp?utm_source=pypi_simpleaible&utm_medium=referral&utm_campaign=simpleaible_readme&utm_content=mcp
|
|
139
|
-
|
|
140
|
-
.. _HTTP Server docs: https://docs.simpleble.org/simpleaible/http?utm_source=pypi_simpleaible&utm_medium=referral&utm_campaign=simpleaible_readme&utm_content=http
|
|
141
|
-
|
|
142
|
-
.. _Agent Skills docs: https://docs.simpleble.org/simpleaible/skills?utm_source=pypi_simpleaible&utm_medium=referral&utm_campaign=simpleaible_readme&utm_content=skills
|
|
143
|
-
|
|
144
|
-
.. |PyPI Licence| image:: https://img.shields.io/pypi/l/simpleaible
|
|
@@ -1,116 +0,0 @@
|
|
|
1
|
-
|PyPI Licence|
|
|
2
|
-
|
|
3
|
-
SimpleAIBLE
|
|
4
|
-
===========
|
|
5
|
-
|
|
6
|
-
An AI-friendly BLE toolkit powered by `SimpleBLE`_. Scan, connect, and interact with Bluetooth Low Energy devices from AI agents and scripts.
|
|
7
|
-
|
|
8
|
-
Key Features
|
|
9
|
-
------------
|
|
10
|
-
|
|
11
|
-
* **MCP Server**: Expose BLE operations as tools for MCP-capable clients (Cursor, Claude Code, Windsurf, etc.)
|
|
12
|
-
* **HTTP Server**: Control BLE devices over a REST API
|
|
13
|
-
* **Agent Skills**: Teach your AI assistant how to work with Bluetooth devices using reusable skill files
|
|
14
|
-
* **Cross-Platform**: Works on Windows, macOS, and Linux
|
|
15
|
-
|
|
16
|
-
Support & Resources
|
|
17
|
-
--------------------
|
|
18
|
-
|
|
19
|
-
We're here to help you succeed with SimpleAIBLE:
|
|
20
|
-
|
|
21
|
-
* **Documentation**: Visit our `docs`_ page for comprehensive guides
|
|
22
|
-
* **Commercial Support**: Check out |website|_ or |email|_ about licensing and professional services.
|
|
23
|
-
* **Community**: Ask questions and share projects in `GitHub Discussions`_
|
|
24
|
-
* **Dongl**: Pair AI-driven BLE workflows with the `official SimpleBLE Bluetooth dongle`_.
|
|
25
|
-
|
|
26
|
-
**Don't hesitate to reach out if you need assistance - we're happy to help!**
|
|
27
|
-
|
|
28
|
-
Installation
|
|
29
|
-
------------
|
|
30
|
-
|
|
31
|
-
Install SimpleAIBLE using your preferred package manager:
|
|
32
|
-
|
|
33
|
-
Using uv (recommended): ::
|
|
34
|
-
|
|
35
|
-
uv tool install simpleaible
|
|
36
|
-
|
|
37
|
-
Or using pip: ::
|
|
38
|
-
|
|
39
|
-
pip install simpleaible
|
|
40
|
-
|
|
41
|
-
MCP Server
|
|
42
|
-
----------
|
|
43
|
-
|
|
44
|
-
Expose BLE operations as tools for MCP-capable clients (Cursor, Claude Code, etc.).
|
|
45
|
-
Configure it in your MCP client with the following command: ``"command": "simpleaible-mcp"``.
|
|
46
|
-
|
|
47
|
-
See the `MCP Server docs`_ for full tool documentation and client-specific setup.
|
|
48
|
-
|
|
49
|
-
HTTP Server
|
|
50
|
-
-----------
|
|
51
|
-
|
|
52
|
-
Run the REST API for controlling BLE devices remotely: ::
|
|
53
|
-
|
|
54
|
-
simpleaible-http --host 127.0.0.1 --port 8000
|
|
55
|
-
|
|
56
|
-
See the `HTTP Server docs`_ for the full API reference.
|
|
57
|
-
|
|
58
|
-
Agent Skills
|
|
59
|
-
------------
|
|
60
|
-
|
|
61
|
-
Install the SimpleAIBLE skill to give your AI agent built-in knowledge of BLE workflows.
|
|
62
|
-
The bundled installer detects Claude Code and Codex automatically: ::
|
|
63
|
-
|
|
64
|
-
simpleaible install
|
|
65
|
-
|
|
66
|
-
Run ``simpleaible uninstall`` to remove the skill again. For other agents, use the ``skills`` CLI: ::
|
|
67
|
-
|
|
68
|
-
npx skills add https://github.com/simpleble/simpleble --skill simpleaible
|
|
69
|
-
|
|
70
|
-
See the `Agent Skills docs`_ for more details.
|
|
71
|
-
|
|
72
|
-
License
|
|
73
|
-
=======
|
|
74
|
-
|
|
75
|
-
SimpleAIBLE follows the `SimpleBLE license`_, the Business Source License 1.1 (BUSL-1.1). It is free for non-commercial
|
|
76
|
-
use, and commercial use needs a commercial license. We offer free commercial licenses for small projects and early-stage
|
|
77
|
-
companies: |email|_ or |leavemessage|_ to discuss your use case. Commercial licenses carry no royalties or revenue
|
|
78
|
-
sharing; see the `licensing page`_ for terms.
|
|
79
|
-
|
|
80
|
-
----
|
|
81
|
-
|
|
82
|
-
**SimpleAIBLE** is a project powered by |caos|_.
|
|
83
|
-
|
|
84
|
-
.. Links
|
|
85
|
-
|
|
86
|
-
.. |email| replace:: email us
|
|
87
|
-
.. _email: mailto:contact@simpleble.org
|
|
88
|
-
|
|
89
|
-
.. |leavemessage| replace:: leave us a message
|
|
90
|
-
.. _leavemessage: https://www.simpleble.org/contact?utm_source=pypi_simpleaible&utm_medium=referral&utm_campaign=simpleaible_readme&utm_content=license
|
|
91
|
-
|
|
92
|
-
.. |website| replace:: our website
|
|
93
|
-
.. _website: https://simpleble.org?utm_source=pypi_simpleaible&utm_medium=referral&utm_campaign=simpleaible_readme&utm_content=support
|
|
94
|
-
|
|
95
|
-
.. |caos| replace:: **The California Open Source Company**
|
|
96
|
-
.. _caos: https://californiaopensource.com?utm_source=pypi_simpleaible&utm_medium=referral&utm_campaign=simpleaible_readme&utm_content=footer
|
|
97
|
-
|
|
98
|
-
.. _SimpleBLE: https://github.com/simpleble/simpleble/
|
|
99
|
-
|
|
100
|
-
.. _SimpleBLE license: https://github.com/simpleble/simpleble/blob/main/LICENSE.md
|
|
101
|
-
|
|
102
|
-
.. _licensing page: https://docs.simpleble.org/licensing?utm_source=pypi_simpleaible&utm_medium=referral&utm_campaign=simpleaible_readme&utm_content=license
|
|
103
|
-
|
|
104
|
-
.. _official SimpleBLE Bluetooth dongle: https://www.simpleble.org/dongl?utm_source=pypi_simpleaible&utm_medium=referral&utm_campaign=simpleaible_readme&utm_content=support
|
|
105
|
-
|
|
106
|
-
.. _docs: https://docs.simpleble.org/?utm_source=pypi_simpleaible&utm_medium=referral&utm_campaign=simpleaible_readme&utm_content=support
|
|
107
|
-
|
|
108
|
-
.. _GitHub Discussions: https://github.com/simpleble/simpleble/discussions
|
|
109
|
-
|
|
110
|
-
.. _MCP Server docs: https://docs.simpleble.org/simpleaible/mcp?utm_source=pypi_simpleaible&utm_medium=referral&utm_campaign=simpleaible_readme&utm_content=mcp
|
|
111
|
-
|
|
112
|
-
.. _HTTP Server docs: https://docs.simpleble.org/simpleaible/http?utm_source=pypi_simpleaible&utm_medium=referral&utm_campaign=simpleaible_readme&utm_content=http
|
|
113
|
-
|
|
114
|
-
.. _Agent Skills docs: https://docs.simpleble.org/simpleaible/skills?utm_source=pypi_simpleaible&utm_medium=referral&utm_campaign=simpleaible_readme&utm_content=skills
|
|
115
|
-
|
|
116
|
-
.. |PyPI Licence| image:: https://img.shields.io/pypi/l/simpleaible
|
|
@@ -1,144 +0,0 @@
|
|
|
1
|
-
Metadata-Version: 2.4
|
|
2
|
-
Name: simpleaible
|
|
3
|
-
Version: 1.2.1.dev106
|
|
4
|
-
Summary: SimpleAIBLE is an AI-friendly BLE toolkit (MCP server & REST API) powered by SimplePyBLE. Free for non-commercial use; commercial use requires a license.
|
|
5
|
-
Author-email: Kevin Dewald <kevin@simpleble.org>
|
|
6
|
-
License-Expression: BUSL-1.1
|
|
7
|
-
Project-URL: Homepage, https://github.com/simpleble/simpleble
|
|
8
|
-
Keywords: ble,bluetooth,mcp,ai,simpleble
|
|
9
|
-
Classifier: Operating System :: Microsoft :: Windows
|
|
10
|
-
Classifier: Operating System :: MacOS
|
|
11
|
-
Classifier: Operating System :: POSIX :: Linux
|
|
12
|
-
Classifier: Programming Language :: Python :: 3
|
|
13
|
-
Classifier: Programming Language :: Python :: 3.10
|
|
14
|
-
Classifier: Programming Language :: Python :: 3.11
|
|
15
|
-
Classifier: Programming Language :: Python :: 3.12
|
|
16
|
-
Classifier: Programming Language :: Python :: 3.13
|
|
17
|
-
Classifier: Programming Language :: Python :: 3.14
|
|
18
|
-
Classifier: Programming Language :: Python :: 3 :: Only
|
|
19
|
-
Requires-Python: >=3.10
|
|
20
|
-
Description-Content-Type: text/x-rst
|
|
21
|
-
License-File: LICENSE.md
|
|
22
|
-
Requires-Dist: simplepyble
|
|
23
|
-
Requires-Dist: fastmcp
|
|
24
|
-
Requires-Dist: fastapi
|
|
25
|
-
Requires-Dist: uvicorn
|
|
26
|
-
Requires-Dist: pydantic
|
|
27
|
-
Dynamic: license-file
|
|
28
|
-
|
|
29
|
-
|PyPI Licence|
|
|
30
|
-
|
|
31
|
-
SimpleAIBLE
|
|
32
|
-
===========
|
|
33
|
-
|
|
34
|
-
An AI-friendly BLE toolkit powered by `SimpleBLE`_. Scan, connect, and interact with Bluetooth Low Energy devices from AI agents and scripts.
|
|
35
|
-
|
|
36
|
-
Key Features
|
|
37
|
-
------------
|
|
38
|
-
|
|
39
|
-
* **MCP Server**: Expose BLE operations as tools for MCP-capable clients (Cursor, Claude Code, Windsurf, etc.)
|
|
40
|
-
* **HTTP Server**: Control BLE devices over a REST API
|
|
41
|
-
* **Agent Skills**: Teach your AI assistant how to work with Bluetooth devices using reusable skill files
|
|
42
|
-
* **Cross-Platform**: Works on Windows, macOS, and Linux
|
|
43
|
-
|
|
44
|
-
Support & Resources
|
|
45
|
-
--------------------
|
|
46
|
-
|
|
47
|
-
We're here to help you succeed with SimpleAIBLE:
|
|
48
|
-
|
|
49
|
-
* **Documentation**: Visit our `docs`_ page for comprehensive guides
|
|
50
|
-
* **Commercial Support**: Check out |website|_ or |email|_ about licensing and professional services.
|
|
51
|
-
* **Community**: Ask questions and share projects in `GitHub Discussions`_
|
|
52
|
-
* **Dongl**: Pair AI-driven BLE workflows with the `official SimpleBLE Bluetooth dongle`_.
|
|
53
|
-
|
|
54
|
-
**Don't hesitate to reach out if you need assistance - we're happy to help!**
|
|
55
|
-
|
|
56
|
-
Installation
|
|
57
|
-
------------
|
|
58
|
-
|
|
59
|
-
Install SimpleAIBLE using your preferred package manager:
|
|
60
|
-
|
|
61
|
-
Using uv (recommended): ::
|
|
62
|
-
|
|
63
|
-
uv tool install simpleaible
|
|
64
|
-
|
|
65
|
-
Or using pip: ::
|
|
66
|
-
|
|
67
|
-
pip install simpleaible
|
|
68
|
-
|
|
69
|
-
MCP Server
|
|
70
|
-
----------
|
|
71
|
-
|
|
72
|
-
Expose BLE operations as tools for MCP-capable clients (Cursor, Claude Code, etc.).
|
|
73
|
-
Configure it in your MCP client with the following command: ``"command": "simpleaible-mcp"``.
|
|
74
|
-
|
|
75
|
-
See the `MCP Server docs`_ for full tool documentation and client-specific setup.
|
|
76
|
-
|
|
77
|
-
HTTP Server
|
|
78
|
-
-----------
|
|
79
|
-
|
|
80
|
-
Run the REST API for controlling BLE devices remotely: ::
|
|
81
|
-
|
|
82
|
-
simpleaible-http --host 127.0.0.1 --port 8000
|
|
83
|
-
|
|
84
|
-
See the `HTTP Server docs`_ for the full API reference.
|
|
85
|
-
|
|
86
|
-
Agent Skills
|
|
87
|
-
------------
|
|
88
|
-
|
|
89
|
-
Install the SimpleAIBLE skill to give your AI agent built-in knowledge of BLE workflows.
|
|
90
|
-
The bundled installer detects Claude Code and Codex automatically: ::
|
|
91
|
-
|
|
92
|
-
simpleaible install
|
|
93
|
-
|
|
94
|
-
Run ``simpleaible uninstall`` to remove the skill again. For other agents, use the ``skills`` CLI: ::
|
|
95
|
-
|
|
96
|
-
npx skills add https://github.com/simpleble/simpleble --skill simpleaible
|
|
97
|
-
|
|
98
|
-
See the `Agent Skills docs`_ for more details.
|
|
99
|
-
|
|
100
|
-
License
|
|
101
|
-
=======
|
|
102
|
-
|
|
103
|
-
SimpleAIBLE follows the `SimpleBLE license`_, the Business Source License 1.1 (BUSL-1.1). It is free for non-commercial
|
|
104
|
-
use, and commercial use needs a commercial license. We offer free commercial licenses for small projects and early-stage
|
|
105
|
-
companies: |email|_ or |leavemessage|_ to discuss your use case. Commercial licenses carry no royalties or revenue
|
|
106
|
-
sharing; see the `licensing page`_ for terms.
|
|
107
|
-
|
|
108
|
-
----
|
|
109
|
-
|
|
110
|
-
**SimpleAIBLE** is a project powered by |caos|_.
|
|
111
|
-
|
|
112
|
-
.. Links
|
|
113
|
-
|
|
114
|
-
.. |email| replace:: email us
|
|
115
|
-
.. _email: mailto:contact@simpleble.org
|
|
116
|
-
|
|
117
|
-
.. |leavemessage| replace:: leave us a message
|
|
118
|
-
.. _leavemessage: https://www.simpleble.org/contact?utm_source=pypi_simpleaible&utm_medium=referral&utm_campaign=simpleaible_readme&utm_content=license
|
|
119
|
-
|
|
120
|
-
.. |website| replace:: our website
|
|
121
|
-
.. _website: https://simpleble.org?utm_source=pypi_simpleaible&utm_medium=referral&utm_campaign=simpleaible_readme&utm_content=support
|
|
122
|
-
|
|
123
|
-
.. |caos| replace:: **The California Open Source Company**
|
|
124
|
-
.. _caos: https://californiaopensource.com?utm_source=pypi_simpleaible&utm_medium=referral&utm_campaign=simpleaible_readme&utm_content=footer
|
|
125
|
-
|
|
126
|
-
.. _SimpleBLE: https://github.com/simpleble/simpleble/
|
|
127
|
-
|
|
128
|
-
.. _SimpleBLE license: https://github.com/simpleble/simpleble/blob/main/LICENSE.md
|
|
129
|
-
|
|
130
|
-
.. _licensing page: https://docs.simpleble.org/licensing?utm_source=pypi_simpleaible&utm_medium=referral&utm_campaign=simpleaible_readme&utm_content=license
|
|
131
|
-
|
|
132
|
-
.. _official SimpleBLE Bluetooth dongle: https://www.simpleble.org/dongl?utm_source=pypi_simpleaible&utm_medium=referral&utm_campaign=simpleaible_readme&utm_content=support
|
|
133
|
-
|
|
134
|
-
.. _docs: https://docs.simpleble.org/?utm_source=pypi_simpleaible&utm_medium=referral&utm_campaign=simpleaible_readme&utm_content=support
|
|
135
|
-
|
|
136
|
-
.. _GitHub Discussions: https://github.com/simpleble/simpleble/discussions
|
|
137
|
-
|
|
138
|
-
.. _MCP Server docs: https://docs.simpleble.org/simpleaible/mcp?utm_source=pypi_simpleaible&utm_medium=referral&utm_campaign=simpleaible_readme&utm_content=mcp
|
|
139
|
-
|
|
140
|
-
.. _HTTP Server docs: https://docs.simpleble.org/simpleaible/http?utm_source=pypi_simpleaible&utm_medium=referral&utm_campaign=simpleaible_readme&utm_content=http
|
|
141
|
-
|
|
142
|
-
.. _Agent Skills docs: https://docs.simpleble.org/simpleaible/skills?utm_source=pypi_simpleaible&utm_medium=referral&utm_campaign=simpleaible_readme&utm_content=skills
|
|
143
|
-
|
|
144
|
-
.. |PyPI Licence| image:: https://img.shields.io/pypi/l/simpleaible
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
{simpleaible-1.2.1.dev106 → simpleaible-1.2.1.dev115}/src/simpleaible/skills/simpleaible/SKILL.md
RENAMED
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
{simpleaible-1.2.1.dev106 → simpleaible-1.2.1.dev115}/src/simpleaible.egg-info/dependency_links.txt
RENAMED
|
File without changes
|
{simpleaible-1.2.1.dev106 → simpleaible-1.2.1.dev115}/src/simpleaible.egg-info/entry_points.txt
RENAMED
|
File without changes
|
|
File without changes
|
{simpleaible-1.2.1.dev106 → simpleaible-1.2.1.dev115}/src/simpleaible.egg-info/top_level.txt
RENAMED
|
File without changes
|