Kortexa Radio

[francip]

What does this Ability do?

Stream KRTX-AI - the AI radio from kortexa.ai

Suggested Trigger Words

• start radio
• stop radio

Type

• New community Ability
• Improvement to existing Ability
• Bug fix
• Documentation update

External APIs

• No external APIs
• Uses external API(s): https://radio.kortexa.ai/stream, https://radio.kortexa.ai/events, no API key required

Testing

• Tested in OpenHome Live Editor
• All exit paths tested (said "stop", "exit", etc.)
• Error scenarios tested (API down, bad input, etc.)

Checklist

• Files are in community/my-ability-name/
• main.py follows SDK pattern (extends MatchingCapability, has register_capability + call)
• README.md included with description, suggested triggers, and setup
• resume_normal_flow() called on every exit path
• No print() — using editor_logging_handler
• No hardcoded API keys — using placeholders
• No blocked imports (redis, connection_manager, user_config)
• No asyncio.sleep() or asyncio.create_task() — using session_tasks
• Error handling on all external calls
• Tested in OpenHome Live Editor

Anything else?

[github-actions]

🔀 Branch Merge Check

PR direction: kortexa/radio → dev

✅ Passed — kortexa/radio → dev is a valid merge direction

[github-actions]

✅ Community PR Path Check — Passed

All changed files are inside the community/ folder. Looks good!

[github-actions]

✅ Ability Validation Passed

📋 Validating: community/kortexa-radio
  ✅ All checks passed!

[github-actions]

🔍 Lint Results

🔧 Auto-formatted

Some files were automatically cleaned and formatted with autoflake + autopep8 and committed.

• ✅ Unused imports removed (autoflake)
• ✅ Unused variables removed (autoflake)
• ✅ PEP8 formatting applied (autopep8)

✅ __init__.py — Empty as expected

Files linted: community/kortexa-radio/main.py

✅ Flake8 — Passed

✅ All checks passed!

[uzair401]

Hey @francip, thanks for the submission! I reviewed the code and SDK compliance and everything looks good on that front. One thing holding us back from a full sign-off is that api.kortexa.ai isn't reachable right now. Connections are timing out on both /radio/stream and /radio/events, so we're not able to do an end-to-end verify just yet. No action needed on your side for now. Once the server is back up we'll pick up testing and move forward from there. Appreciate your patience!

[francip]

that's my bad, I traveled, and had to take the mini with me. the machine is back up, the two streams should be reachable. I'll move this on a different machine that never leaves my desk in the next day or so to avoid disruptions like this.