Metadata-Version: 2.4
Name: telegen_iot
Version: 0.0.1.dev2
Summary: A virtual IoT hardware simulator.
Home-page: https://github.com/Jeansonnej23/TeleGen-IoT
Author: Joe Jeansonne
Maintainer: Joe Jeansonne
License: MIT
Project-URL: Documentation, https://github.com/Jeansonnej23/TeleGen-IoT
Project-URL: Source Code, https://github.com/Jeansonnej23/TeleGen-IoT
Project-URL: Issue Tracker, https://github.com/Jeansonnej23/TeleGen-IoT
Classifier: Development Status :: 2 - Pre-Alpha
Classifier: Intended Audience :: Developers
Classifier: Topic :: System :: Hardware
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
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
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: Flask==3.1.1
Requires-Dist: Flask-SocketIO==5.5.1
Provides-Extra: test
Requires-Dist: pytest==7.2.2; extra == "test"
Dynamic: license-file

# Telegen_IoT

IoT is great fun, but has a downside - hardware. You need access to a range of devices such as sensors and actuators to build your IoT projects. Sometimes you might have these devices, other times you may not - maybe you are waiting for a delivery, or parts are out of stock, or they are too expensive.

That's where this tool comes in.

## What is Telegen_IoT

Telegen_IoT is a tool that is designed to fake various IoT hardware components, such as LEDs, buttons, temperature sensors and the like, that you can then access from IoT device code running on your computer rather than on an IoT device. It is made of two parts:

* The Telegen_IoT app - this is a web app run locally where you can connect fake sensors and actuators to your virtual hardware
* Shims - these are libraries that mimic popular hardware APIs so you can take code that runs against well known hardware and run it against the Telegen-IoT app.

## Getting started

* Install the Telegen_IoT app:

    ```sh
    pip install telegen_iot
    ```

* Run the app:

    ```sh
    telegen_iot
    ```

* The app will launch, listening for web requests on port 5000, and open a web browser for you to start adding virtual sensors and actuators to your project

### Running on a different port

To use a different port than the default 5000, set the `--port` option when you run the app:

```sh
telegen_iot --port 5050
```

## Connecting your code

You can connect your device code to Telegen-IoT, using one of the available shims. See the [shim list for more details](https://github.com/Jeansonnej23/TeleGen#shims).
