This release is a pre-release and may not be stable for production use.
SimpleAIBLE
An AI-friendly BLE toolkit powered by SimpleBLE. Scan, connect, and interact with Bluetooth Low Energy devices from AI agents and scripts.
Key Features
MCP Server: Expose BLE operations as tools for MCP-capable clients (Cursor, Claude Code, Windsurf, etc.)
HTTP Server: Control BLE devices over a REST API
Agent Skills: Teach your AI assistant how to work with Bluetooth devices using reusable skill files
Cross-Platform: Works on Windows, macOS, and Linux
Support & Resources
We’re here to help you succeed with SimpleAIBLE:
Documentation: Visit our docs page for comprehensive guides
Commercial Support: Check out our website or email us about licensing and professional services.
Community: Join our Discord server for discussions and help
Dongl: Pair AI-driven BLE workflows with the official SimpleBLE Bluetooth dongle.
Don’t hesitate to reach out if you need assistance - we’re happy to help!
Installation
Install SimpleAIBLE using your preferred package manager:
Using uv (recommended):
uv tool install simpleaible
Or using pip:
pip install simpleaible
MCP Server
Expose BLE operations as tools for MCP-capable clients (Cursor, Claude Code, etc.). Configure it in your MCP client with the following command: "command": "simpleaible-mcp".
See the MCP Server docs for full tool documentation and client-specific setup.
HTTP Server
Run the REST API for controlling BLE devices remotely:
simpleaible-http --host 127.0.0.1 --port 8000
See the HTTP Server docs for the full API reference.
Agent Skills
Install the SimpleAIBLE skill to give your AI agent built-in knowledge of BLE workflows. The bundled installer detects Claude Code and Codex automatically:
simpleaible install
Run simpleaible uninstall to remove the skill again. For other agents, use the skills CLI:
npx skills add https://github.com/simpleble/simpleble --skill simpleaible
See the Agent Skills docs for more details.
License
SimpleAIBLE is available under the Business Source License 1.1 (BUSL-1.1). Each version of SimpleAIBLE will convert to the GNU General Public License version 3 after four years of its initial release. Qualifying non-commercial users may instead continue using and distributing that version under the original BUSL-1.1 terms under the Non-Commercial Perpetual Use Grant in LICENSE.md.
The project is free to use for non-commercial purposes, but requires a commercial license for commercial use. We also offer FREE commercial licenses for small projects and early-stage companies - reach out to discuss your use case!
Why purchase a commercial license?
Build and deploy unlimited commercial applications
Use across your entire development team
Zero revenue sharing or royalty payments
Choose features that match your needs and budget
Priority technical support included
Clear terms for integrating into MIT-licensed projects
Looking for information on pricing and commercial terms of service? Visit www.simpleble.org for more details.
For further enquiries, please email us or leave us a message on our website and we can discuss the specifics of your situation.
SimpleAIBLE is a project powered by The California Open Source Company.
2 maintainers
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file simpleaible-1.1.1.dev24.tar.gz.
File metadata
- Download URL: simpleaible-1.1.1.dev24.tar.gz
- Upload date:
- Size: 14.9 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
f6f766072a36f55c331205c914839d1ce3f1289cfa4926a7461dbddda01e35be
|
|
| MD5 |
361ff864db2ebb0a97168dad2cd780e9
|
|
| BLAKE2b-256 |
d2294767a92bbbfac50cc7a9da6b37ca5c0d6cc84851e9a79b0d9d1ddd878101
|
File details
Details for the file simpleaible-1.1.1.dev24-py3-none-any.whl.
File metadata
- Download URL: simpleaible-1.1.1.dev24-py3-none-any.whl
- Upload date:
- Size: 16.1 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
184d7940dc0fbcd5bd5c71b7e4c4ff0011b2e359ef0b3975bfb9971ed21c9afc
|
|
| MD5 |
4fb24471ac1171fc516e7ac32a904690
|
|
| BLAKE2b-256 |
fc0b6464e8cb733680e4ac7a39396379f16562751724f6b5d22c7d5edb073dba
|
