syryn 0.1.0__tar.gz

syryn-0.1.0/PKG-INFO

@@ -0,0 +1,116 @@
+Metadata-Version: 2.4
+Name: syryn
+Version: 0.1.0
+Summary: Bluetooth identity beacon for headless Linux devices — returns hostname, mDNS, and active network interfaces over RFCOMM.
+Project-URL: Homepage, https://github.com/szholobetsky/syryn
+Project-URL: Repository, https://github.com/szholobetsky/syryn
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: PyBluez2>=0.46
+Requires-Dist: psutil>=5.9
+Requires-Dist: requests>=2.28
+
+![syryn](https://raw.githubusercontent.com/szholobetsky/simrgl/main/images/logo/syryn.png)
+
+# syryn
+
+Bluetooth identity beacon for headless Linux devices.
+
+The name comes from *Сирин* — a bird from Slavic mythology known for its voice. Syryn speaks when asked: it listens on a Bluetooth RFCOMM channel and responds with the device's hostname, mDNS address, and active network interfaces.
+
+---
+
+## What it does
+
+Run `syryn` on a headless mini-PC. From any nearby Bluetooth device, send `STATUS` — and get back:
+
+```
+hostname: panteon-john
+mdns: panteon-john.local
+eth0: 192.168.0.131
+wlan0: 192.168.1.44
+external_ip: 93.12.34.56
+```
+
+No display needed. No SSH session. No prior knowledge of the IP address.
+
+---
+
+## Install & quick start
+
+### 1. System packages (one-time)
+
+Debian / Ubuntu:
+```bash
+sudo apt install bluez python3-dev libbluetooth-dev python3-pip
+```
+
+Fedora / RHEL:
+```bash
+sudo dnf install bluez bluez-libs-devel python3-devel python3-pip
+```
+
+### 2. Enable Bluetooth
+
+```bash
+systemctl status bluetooth        # check if bluetoothd is running
+sudo systemctl enable bluetooth --now   # start and enable on boot
+
+rfkill list                       # check if adapter is blocked
+sudo rfkill unblock bluetooth     # unblock if needed
+```
+
+### 3. Install syryn
+
+```bash
+pip install syryn
+```
+
+### 4. Run
+
+```bash
+syryn          # start beacon, prints port and hostname
+syryn -q       # quiet mode, no output
+```
+
+Syryn starts a Bluetooth RFCOMM server and waits for connections.
+The Bluetooth device name visible to other devices is the system hostname
+(set via `hostnamectl set-hostname <name>`).
+
+### 5. Connect from another device
+
+From any device with a Bluetooth terminal app (e.g. **Serial Bluetooth Terminal** on Android):
+
+1. Pair with the headless device
+2. Connect to the **Syryn** service
+3. Send `STATUS` — receive hostname, mDNS, interfaces, external IP
+
+---
+
+## Requirements
+
+- Linux with BlueZ (`bluetoothd` running)
+- Python 3.10+
+- `PyBluez2`, `psutil`, `requests`
+
+---
+
+## Part of the SIMARGL toolkit
+
+syryn is one of seven tools that together form an **intellectual development support system**:
+
+| Tool | Role |
+|---|---|
+| **[simargl](https://github.com/szholobetsky/simargl)** | Task-to-code retrieval — given a task description, finds which files and modules are likely affected, using semantic similarity over git history |
+| **[svitovyd](https://github.com/szholobetsky/svitovyd)** | Project map — scans any codebase and produces a structural map of definitions and cross-file dependencies; exposes it as an MCP server |
+| **[1bcoder](https://github.com/szholobetsky/1bcoder)** | AI coding assistant for small local models — surgical context management, agents, parallel inference, proc scripts |
+| **[yasna](https://github.com/szholobetsky/yasna)** | Session memory — indexes conversations from all AI agents so you can find what was discussed, when, and where |
+| **[radogast](https://github.com/szholobetsky/radogast)** | Context drift monitor — measures how far an AI agent's conversation has drifted from the original task |
+| **[vyrii](https://github.com/szholobetsky/vyrii)** | Local AI web UI — chat, translate, web research, RAG, and file management via Gradio; powered by Ollama or any OpenAI-compatible backend |
+| **[syryn](https://github.com/szholobetsky/syryn)** | Bluetooth identity beacon — returns hostname, mDNS, and active network interfaces for headless devices |
+
+---
+
+**(c) 2026 Stanislav Zholobetskyi, Oleh Andriichuk**
+Institute for Information Recording, National Academy of Sciences of Ukraine, Kyiv
+*PhD research: «Intelligent Technology for Software Development and Maintenance Support»*

syryn-0.1.0/README.md

@@ -0,0 +1,104 @@
+![syryn](https://raw.githubusercontent.com/szholobetsky/simrgl/main/images/logo/syryn.png)
+
+# syryn
+
+Bluetooth identity beacon for headless Linux devices.
+
+The name comes from *Сирин* — a bird from Slavic mythology known for its voice. Syryn speaks when asked: it listens on a Bluetooth RFCOMM channel and responds with the device's hostname, mDNS address, and active network interfaces.
+
+---
+
+## What it does
+
+Run `syryn` on a headless mini-PC. From any nearby Bluetooth device, send `STATUS` — and get back:
+
+```
+hostname: panteon-john
+mdns: panteon-john.local
+eth0: 192.168.0.131
+wlan0: 192.168.1.44
+external_ip: 93.12.34.56
+```
+
+No display needed. No SSH session. No prior knowledge of the IP address.
+
+---
+
+## Install & quick start
+
+### 1. System packages (one-time)
+
+Debian / Ubuntu:
+```bash
+sudo apt install bluez python3-dev libbluetooth-dev python3-pip
+```
+
+Fedora / RHEL:
+```bash
+sudo dnf install bluez bluez-libs-devel python3-devel python3-pip
+```
+
+### 2. Enable Bluetooth
+
+```bash
+systemctl status bluetooth        # check if bluetoothd is running
+sudo systemctl enable bluetooth --now   # start and enable on boot
+
+rfkill list                       # check if adapter is blocked
+sudo rfkill unblock bluetooth     # unblock if needed
+```
+
+### 3. Install syryn
+
+```bash
+pip install syryn
+```
+
+### 4. Run
+
+```bash
+syryn          # start beacon, prints port and hostname
+syryn -q       # quiet mode, no output
+```
+
+Syryn starts a Bluetooth RFCOMM server and waits for connections.
+The Bluetooth device name visible to other devices is the system hostname
+(set via `hostnamectl set-hostname <name>`).
+
+### 5. Connect from another device
+
+From any device with a Bluetooth terminal app (e.g. **Serial Bluetooth Terminal** on Android):
+
+1. Pair with the headless device
+2. Connect to the **Syryn** service
+3. Send `STATUS` — receive hostname, mDNS, interfaces, external IP
+
+---
+
+## Requirements
+
+- Linux with BlueZ (`bluetoothd` running)
+- Python 3.10+
+- `PyBluez2`, `psutil`, `requests`
+
+---
+
+## Part of the SIMARGL toolkit
+
+syryn is one of seven tools that together form an **intellectual development support system**:
+
+| Tool | Role |
+|---|---|
+| **[simargl](https://github.com/szholobetsky/simargl)** | Task-to-code retrieval — given a task description, finds which files and modules are likely affected, using semantic similarity over git history |
+| **[svitovyd](https://github.com/szholobetsky/svitovyd)** | Project map — scans any codebase and produces a structural map of definitions and cross-file dependencies; exposes it as an MCP server |
+| **[1bcoder](https://github.com/szholobetsky/1bcoder)** | AI coding assistant for small local models — surgical context management, agents, parallel inference, proc scripts |
+| **[yasna](https://github.com/szholobetsky/yasna)** | Session memory — indexes conversations from all AI agents so you can find what was discussed, when, and where |
+| **[radogast](https://github.com/szholobetsky/radogast)** | Context drift monitor — measures how far an AI agent's conversation has drifted from the original task |
+| **[vyrii](https://github.com/szholobetsky/vyrii)** | Local AI web UI — chat, translate, web research, RAG, and file management via Gradio; powered by Ollama or any OpenAI-compatible backend |
+| **[syryn](https://github.com/szholobetsky/syryn)** | Bluetooth identity beacon — returns hostname, mDNS, and active network interfaces for headless devices |
+
+---
+
+**(c) 2026 Stanislav Zholobetskyi, Oleh Andriichuk**
+Institute for Information Recording, National Academy of Sciences of Ukraine, Kyiv
+*PhD research: «Intelligent Technology for Software Development and Maintenance Support»*

syryn-0.1.0/pyproject.toml

@@ -0,0 +1,29 @@
+[build-system]
+requires = ["setuptools>=68", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "syryn"
+version = "0.1.0"
+description = "Bluetooth identity beacon for headless Linux devices — returns hostname, mDNS, and active network interfaces over RFCOMM."
+requires-python = ">=3.10"
+readme = {file = "README.md", content-type = "text/markdown"}
+dependencies = [
+    "PyBluez2>=0.46",
+    "psutil>=5.9",
+    "requests>=2.28",
+]
+
+[project.urls]
+Homepage   = "https://github.com/szholobetsky/syryn"
+Repository = "https://github.com/szholobetsky/syryn"
+
+[project.scripts]
+syryn = "syryn.__main__:main"
+
+[tool.setuptools.packages.find]
+where = ["."]
+include = ["syryn*"]
+
+[tool.setuptools.package-data]
+"syryn" = ["**/*"]

syryn-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

syryn-0.1.0/syryn/__init__.py

@@ -0,0 +1 @@
+__version__ = "0.1.0"

syryn-0.1.0/syryn/__main__.py

@@ -0,0 +1,16 @@
+import argparse
+from .syryn import serve
+
+
+def main() -> None:
+    p = argparse.ArgumentParser(
+        prog="syryn",
+        description="Bluetooth identity beacon — responds to STATUS over RFCOMM",
+    )
+    p.add_argument("-q", "--quiet", action="store_true", help="suppress log output")
+    args = p.parse_args()
+    serve(verbose=not args.quiet)
+
+
+if __name__ == "__main__":
+    main()

syryn-0.1.0/syryn/syryn.py

@@ -0,0 +1,112 @@
+"""RFCOMM server: listens for Bluetooth connections, responds to STATUS command."""
+from __future__ import annotations
+
+import datetime
+import socket
+import sys
+
+try:
+    import bluetooth
+except ModuleNotFoundError:
+    sys.exit(
+        "syryn requires PyBluez2 and Linux BlueZ.\n"
+        "Debian/Ubuntu:  sudo apt install bluez python3-dev libbluetooth-dev\n"
+        "Fedora/RHEL:    sudo dnf install bluez bluez-libs-devel python3-devel\n"
+        "Then:           pip install PyBluez2"
+    )
+
+import psutil
+import requests
+
+CACHE_TTL = 300
+
+_ip_cache: dict = {}
+
+
+def get_hostname() -> str:
+    return socket.gethostname()
+
+
+def get_interfaces() -> list[tuple[str, str]]:
+    stats = psutil.net_if_stats()
+    result = []
+    for name, addr_list in psutil.net_if_addrs().items():
+        if not stats.get(name) or not stats[name].isup:
+            continue
+        for addr in addr_list:
+            if addr.family == socket.AF_INET and not addr.address.startswith("127."):
+                result.append((name, addr.address))
+    return result
+
+
+def get_external_ip() -> str:
+    now = datetime.datetime.now()
+    if "ip" in _ip_cache and (now - _ip_cache["ts"]).total_seconds() < CACHE_TTL:
+        return _ip_cache["ip"]
+    try:
+        ip = requests.get("https://api.ipify.org", timeout=5).text.strip()
+        _ip_cache.update({"ip": ip, "ts": now})
+        return ip
+    except Exception:
+        return _ip_cache.get("ip", "unknown")
+
+
+def build_status() -> str:
+    hostname = get_hostname()
+    lines = [f"hostname: {hostname}", f"mdns: {hostname}.local"]
+    for name, ip in get_interfaces():
+        lines.append(f"{name}: {ip}")
+    lines.append(f"external_ip: {get_external_ip()}")
+    return "\n".join(lines)
+
+
+def _handle_client(client_sock: bluetooth.BluetoothSocket) -> None:
+    try:
+        while True:
+            data = client_sock.recv(1024)
+            if not data:
+                break
+            cmd = data.decode("utf-8", errors="ignore").strip()
+            if not cmd or cmd.upper() == "STATUS":
+                client_sock.sendall((build_status() + "\n").encode("utf-8"))
+    except OSError:
+        pass
+    finally:
+        client_sock.close()
+
+
+def serve(verbose: bool = True) -> None:
+    server_sock = bluetooth.BluetoothSocket(bluetooth.RFCOMM)
+    server_sock.bind(("", bluetooth.PORT_ANY))
+    server_sock.listen(1)
+    port = server_sock.getsockname()[1]
+
+    try:
+        bluetooth.advertise_service(
+            server_sock,
+            "Syryn",
+            service_classes=[bluetooth.SERIAL_PORT_CLASS],
+            profiles=[bluetooth.SERIAL_PORT_PROFILE],
+        )
+    except Exception as e:
+        if verbose:
+            print(f"[syryn] SDP advertise skipped: {e}")
+
+    if verbose:
+        print(f"[syryn] RFCOMM port {port}  |  hostname: {get_hostname()}")
+        print("[syryn] waiting for connections (Ctrl+C to stop)")
+
+    try:
+        while True:
+            client_sock, addr = server_sock.accept()
+            if verbose:
+                print(f"[syryn] connected: {addr}")
+            _handle_client(client_sock)
+            if verbose:
+                print(f"[syryn] disconnected: {addr}")
+    except KeyboardInterrupt:
+        pass
+    finally:
+        server_sock.close()
+        if verbose:
+            print("[syryn] stopped")

syryn-0.1.0/syryn.egg-info/PKG-INFO

@@ -0,0 +1,116 @@
+Metadata-Version: 2.4
+Name: syryn
+Version: 0.1.0
+Summary: Bluetooth identity beacon for headless Linux devices — returns hostname, mDNS, and active network interfaces over RFCOMM.
+Project-URL: Homepage, https://github.com/szholobetsky/syryn
+Project-URL: Repository, https://github.com/szholobetsky/syryn
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: PyBluez2>=0.46
+Requires-Dist: psutil>=5.9
+Requires-Dist: requests>=2.28
+
+![syryn](https://raw.githubusercontent.com/szholobetsky/simrgl/main/images/logo/syryn.png)
+
+# syryn
+
+Bluetooth identity beacon for headless Linux devices.
+
+The name comes from *Сирин* — a bird from Slavic mythology known for its voice. Syryn speaks when asked: it listens on a Bluetooth RFCOMM channel and responds with the device's hostname, mDNS address, and active network interfaces.
+
+---
+
+## What it does
+
+Run `syryn` on a headless mini-PC. From any nearby Bluetooth device, send `STATUS` — and get back:
+
+```
+hostname: panteon-john
+mdns: panteon-john.local
+eth0: 192.168.0.131
+wlan0: 192.168.1.44
+external_ip: 93.12.34.56
+```
+
+No display needed. No SSH session. No prior knowledge of the IP address.
+
+---
+
+## Install & quick start
+
+### 1. System packages (one-time)
+
+Debian / Ubuntu:
+```bash
+sudo apt install bluez python3-dev libbluetooth-dev python3-pip
+```
+
+Fedora / RHEL:
+```bash
+sudo dnf install bluez bluez-libs-devel python3-devel python3-pip
+```
+
+### 2. Enable Bluetooth
+
+```bash
+systemctl status bluetooth        # check if bluetoothd is running
+sudo systemctl enable bluetooth --now   # start and enable on boot
+
+rfkill list                       # check if adapter is blocked
+sudo rfkill unblock bluetooth     # unblock if needed
+```
+
+### 3. Install syryn
+
+```bash
+pip install syryn
+```
+
+### 4. Run
+
+```bash
+syryn          # start beacon, prints port and hostname
+syryn -q       # quiet mode, no output
+```
+
+Syryn starts a Bluetooth RFCOMM server and waits for connections.
+The Bluetooth device name visible to other devices is the system hostname
+(set via `hostnamectl set-hostname <name>`).
+
+### 5. Connect from another device
+
+From any device with a Bluetooth terminal app (e.g. **Serial Bluetooth Terminal** on Android):
+
+1. Pair with the headless device
+2. Connect to the **Syryn** service
+3. Send `STATUS` — receive hostname, mDNS, interfaces, external IP
+
+---
+
+## Requirements
+
+- Linux with BlueZ (`bluetoothd` running)
+- Python 3.10+
+- `PyBluez2`, `psutil`, `requests`
+
+---
+
+## Part of the SIMARGL toolkit
+
+syryn is one of seven tools that together form an **intellectual development support system**:
+
+| Tool | Role |
+|---|---|
+| **[simargl](https://github.com/szholobetsky/simargl)** | Task-to-code retrieval — given a task description, finds which files and modules are likely affected, using semantic similarity over git history |
+| **[svitovyd](https://github.com/szholobetsky/svitovyd)** | Project map — scans any codebase and produces a structural map of definitions and cross-file dependencies; exposes it as an MCP server |
+| **[1bcoder](https://github.com/szholobetsky/1bcoder)** | AI coding assistant for small local models — surgical context management, agents, parallel inference, proc scripts |
+| **[yasna](https://github.com/szholobetsky/yasna)** | Session memory — indexes conversations from all AI agents so you can find what was discussed, when, and where |
+| **[radogast](https://github.com/szholobetsky/radogast)** | Context drift monitor — measures how far an AI agent's conversation has drifted from the original task |
+| **[vyrii](https://github.com/szholobetsky/vyrii)** | Local AI web UI — chat, translate, web research, RAG, and file management via Gradio; powered by Ollama or any OpenAI-compatible backend |
+| **[syryn](https://github.com/szholobetsky/syryn)** | Bluetooth identity beacon — returns hostname, mDNS, and active network interfaces for headless devices |
+
+---
+
+**(c) 2026 Stanislav Zholobetskyi, Oleh Andriichuk**
+Institute for Information Recording, National Academy of Sciences of Ukraine, Kyiv
+*PhD research: «Intelligent Technology for Software Development and Maintenance Support»*

syryn-0.1.0/syryn.egg-info/SOURCES.txt

@@ -0,0 +1,11 @@
+README.md
+pyproject.toml
+syryn/__init__.py
+syryn/__main__.py
+syryn/syryn.py
+syryn.egg-info/PKG-INFO
+syryn.egg-info/SOURCES.txt
+syryn.egg-info/dependency_links.txt
+syryn.egg-info/entry_points.txt
+syryn.egg-info/requires.txt
+syryn.egg-info/top_level.txt

syryn-0.1.0/syryn.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

syryn-0.1.0/syryn.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+syryn = syryn.__main__:main

syryn-0.1.0/syryn.egg-info/requires.txt

@@ -0,0 +1,3 @@
+PyBluez2>=0.46
+psutil>=5.9
+requests>=2.28

syryn-0.1.0/syryn.egg-info/top_level.txt

@@ -0,0 +1 @@
+syryn