Metadata-Version: 2.4
Name: simpleaible
Version: 1.2.1.dev105
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.
Author-email: Kevin Dewald <kevin@simpleble.org>
License-Expression: BUSL-1.1
Project-URL: Homepage, https://github.com/simpleble/simpleble
Keywords: ble,bluetooth,mcp,ai,simpleble
Classifier: Operating System :: Microsoft :: Windows
Classifier: Operating System :: MacOS
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Programming Language :: Python :: 3 :: Only
Requires-Python: >=3.10
Description-Content-Type: text/x-rst
License-File: LICENSE.md
Requires-Dist: simplepyble
Requires-Dist: fastmcp
Requires-Dist: fastapi
Requires-Dist: uvicorn
Requires-Dist: pydantic
Dynamic: license-file

|PyPI Licence|

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 |website|_ or |email|_ 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 follows the `SimpleBLE license`_, the Business Source License 1.1 (BUSL-1.1). It is free for non-commercial
use, and commercial use needs a commercial license. We offer free commercial licenses for small projects and early-stage
companies: |email|_ or |leavemessage|_ to discuss your use case. Commercial licenses carry no royalties or revenue
sharing; see the `licensing page`_ for terms.

----

**SimpleAIBLE** is a project powered by |caos|_.

.. Links

.. |email| replace:: email us
.. _email: mailto:contact@simpleble.org

.. |leavemessage| replace:: leave us a message
.. _leavemessage: https://www.simpleble.org/contact?utm_source=pypi_simpleaible&utm_medium=referral&utm_campaign=simpleaible_readme

.. |website| replace:: our website
.. _website: https://simpleble.org?utm_source=pypi_simpleaible&utm_medium=referral&utm_campaign=simpleaible_readme

.. |caos| replace:: **The California Open Source Company**
.. _caos: https://californiaopensource.com?utm_source=pypi_simpleaible&utm_medium=referral&utm_campaign=simpleaible_readme

.. _SimpleBLE: https://github.com/simpleble/simpleble/

.. _SimpleBLE license: https://github.com/simpleble/simpleble/blob/main/LICENSE.md

.. _licensing page: https://docs.simpleble.org/licensing

.. _official SimpleBLE Bluetooth dongle: https://www.simpleble.org/dongl?utm_source=pypi_simpleaible&utm_medium=referral&utm_campaign=dongl_launch

.. _docs: https://docs.simpleble.org/

.. _Discord: https://discord.gg/N9HqNEcvP3

.. _MCP Server docs: https://docs.simpleble.org/simpleaible/mcp

.. _HTTP Server docs: https://docs.simpleble.org/simpleaible/http

.. _Agent Skills docs: https://docs.simpleble.org/simpleaible/skills

.. |PyPI Licence| image:: https://img.shields.io/pypi/l/simpleaible
