Helio

An educational app for testing and comprehending python
and rust capabilities to interact, monitor, and capture stream
data for a small number of specific internet sites.
(primarliy mature / adult sites)

Helio ...new direction (2025-06-30)

Having recently viewed some rust code. I decided on impulse to take Helio into rusty land.
Therefore, a pure python Helio is lower on the time allocation list.
Follow as I learn and implement rust.

Considerations | Installation | Config | Dev Notes |
Tech | Sites | Disclaimer | Usage |

Platform: Linux

---

Considerations

• Fast storage (SSD) for real-time access
  • Helio can capture as many streams as your system can handle
• Whatever long term storage for videos

⬆️

---

Installation

Prerequisite

• Rust

  • Rust install instructions

• uv - An ultra fast project and package manager.

  • uv install instructions

**Optional, populate .env with applicable strings.

An example is in the root directory.

• env_example

Expect Helio to create folders and databases.

Clone Helio from github

Recommended install steps

• Note: The uv cache location impacts performance.

  • A cache on a drive separate from the project may generate uv errors

export UV_CACHE_DIR=<place on same drive as project>
git clone https://github.com/beyChill/helio.git
cd helio
uv venv .venv --prompt Helio
source .venv/bin/activate
uv sync
uv pip install -e .
uv run stardust/setup_dirs.py

⬆️

---

Config

Managed setting are located in settings.py file. ( Path: stardust/config/settings.py ) The thought was simple in the beginning. However, as Helio grows so does the size of settings.py. Perhaps beyChill will look into other options. Consideration is being made for live config changes.

⬆️

---

Dev Notes

Windows compatibility: ZERO interest.
Any user is free to modify this software for use on platforms outside of Linux

⬆️

---

Tech

Knowledge share for some packages in Helio's tech stack

• cmd2: Cli
• rnet: TLS/HTTP2 client
• pygithub: Access GitHub api
• python-dotenv: Environment variables

⬆️

---

Sites

• Chaturbate: active
• StripChat: planning
• MyFreeCams: active
• StreaMate: planning

⬆️

---

Disclaimer

beyChill does not provide any warranty of any kind, expressed or implied, relating to the open-source Helio and its use. beyChill disclaims all expressed and/or implied warranties and conditions pertaining in any way to any open-source integrated into Helio code. beyChill does not warrant that Helio will integrate error-free with other software running on any machine. Helio may become abandoned at any time. beyChill is not required to provide prior notice for Helio depreciated support. Use of Helio will never require any monetary exchange. beyChill will never request any donation and/or compensation for Helio.

⬆️

---

Usage

Make sure the .venv is active.

$ source .venv/bin/activate
(helio) $

Run setup_dirs.py from stardust directory prior to accessing cli.

Run start script from stardust directory.
( help screen is visible after entering the help command )

(helio) $ uv run stardust/start.py

# use help command to access features
Helio--> help

# use load command to switch sites
Helio--> load cb
chaturbate interactions are ready
CB-->  get ann456
22:02:56 [CAPTURING]: ann456 [CB]
CB-->  load mfc
myfreecams interactions are ready
MFC--> get emma_hot
05:49:56 [CAPTURING]: emma_hot [MFC]
MFC--> unload mfc
Helio--> quit

IMPORTANT

The different sites cli (cb, mfc, sc, etc.) use commands with identical names.
Issue the 'load' command for the specific site to obtain the desired results.

helio--> load mfc
myfreecams interactions are ready
MFC--> get adysweet
05:18:56 [CAPTURING]: adysweet [MFC]