syryn 0.1.0

Bluetooth identity beacon for headless Linux devices — returns hostname, mDNS, and active network interfaces over RFCOMM.

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:

sudo apt install bluez python3-dev libbluetooth-dev python3-pip

Fedora / RHEL:

sudo dnf install bluez bluez-libs-devel python3-devel python3-pip

2. Enable Bluetooth

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

pip install syryn

4. Run

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	Task-to-code retrieval — given a task description, finds which files and modules are likely affected, using semantic similarity over git history
svitovyd	Project map — scans any codebase and produces a structural map of definitions and cross-file dependencies; exposes it as an MCP server
1bcoder	AI coding assistant for small local models — surgical context management, agents, parallel inference, proc scripts
yasna	Session memory — indexes conversations from all AI agents so you can find what was discussed, when, and where
radogast	Context drift monitor — measures how far an AI agent's conversation has drifted from the original task
vyrii	Local AI web UI — chat, translate, web research, RAG, and file management via Gradio; powered by Ollama or any OpenAI-compatible backend
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»