[Good First Issue]: Update ubuntu runners to self hosted solution

[exploreriii]

🆕🐥 Newcomer Friendly

This Good First Issue is a guided, well-scoped task intended for new human contributors to the Hiero Python SDK.

What you’ll do

• ✅ understand how the repository is structured
• ✅ practice the standard contribution workflow
• ✅ submit and merge a pull request

Support

A maintainer or mentor actively monitors this issue and will help guide it to completion.

Important

This issue does not require prior domain knowledge.

• No Hiero or Hedera experience needed
• No distributed ledger background required
• Basic Python and Git are sufficient

Note

⏱️ Typical time to complete: 30–90 minutes (once setup is done)
🧩 Difficulty: Small, well-contained change
🎓 Best for: New contributors

🏁 Completion
When this issue is complete, you will have:

• ✅ Solved a real issue
• ✅ A merged pull request in the Hiero Python SDK
• ✅ Your name in the project history
• ✅ Confidence to take on larger issues next

👾 Issue description

The following workflow use ubuntu runners that need updating:

.github/workflows/deps-check.yml
.github/workflows/pr-check-examples.yml
.github/workflows/pr-check-test-files.yml
.github/workflows/pr-check-test.yml

Instead, these should run on: hl-sdk-py-lin-md

💡 Proposed Solution

We should update from ubuntu to the custom solution

🛠️ Implementation Steps

Replace each of those workflows to use exactly:

hl-sdk-py-lin-md

.github/workflows/deps-check.yml
.github/workflows/pr-check-examples.yml
.github/workflows/pr-check-test-files.yml
.github/workflows/pr-check-test.yml

Ensure to keep all styling and content identical other than that

Thank you!

---

📋 Step-by-Step Setup Guide

Suggestions:

• Visual Studio (VS) Code: Guide

• GitHub Desktop: Guide

• Hedera Testnet Account with root .env file: Guide

• Create a GPG key linked to GitHub: Guide

Setup the Hiero Python SDK for development

• Fork Create an online and local copy of the repository: Guide

• Connect origin with upstream: Guide

• Install Packages and protobufs: Guide (or Windows Setup Guide for Windows users)

• Sync Main pull any recent upstream changes: Guide

You are set up! 🎉

📋 Step-by-step contribution guide

✅ Get ready

• Claim the issue: comment /assign: Guide. Pull requests created without being assigned will be automatically closed.

• Double check the Issue and AI plan: carefully re-read the issue description and the CodeRabbit AI plan

• Ask questions early: ask on Discord, your @mentor (Python SDK help) and the @good_first_issue_support_team (setup and workflow help)

• Sync with main: pull the latest upstream changes Guide

• 💡 Tip: Before coding, leave a short comment describing what you plan to change. We’ll confirm you’re on the right track.

🛠️ Solve the Issue

• Create a branch from main: Guide

• Implement the solution: follow the implementation steps in the issue description.

• Commit with DCO and GPG signing: commit changes using: git commit -S -s -m "chore: your message", Guide

• Add a .CHANGELOG.md entry: under the appropriate [UNRELEASED] section and commit as git commit -S -s -m "chore: changelog entry" Guide

🚀 Create the pull request

• Push your commits: push your branch to your fork git push origin your-branch-name

• Open a pull request: here guide

• Complete the PR description: briefly describe your changes, Guide

• Link the Issue: link the issue the PR solves in the PR description, Guide. Pull requests created without a linked issue will be automatically closed.

• Submit the pull request: click **Create pull request** 🎉

✅ Acceptance criteria

To be able to close this issue, the following criteria must be met:

• The issue is solved: I’ve carefully read and implemented the issue requirements

• I did not add extra changes: I did not modify anything beyond what is described in the issue

• Behavior: All other existing features continue to work as before

• Checks and feedback: All checks pass and any requested changes have been made

🧭 Getting help if you’re stuck

If questions come up, don’t spend more than 20 minutes blocked.

Tip

• Comment on this issue and tag @good_first_issue_support_team or @mentor_name
• Ask for help in Discord

---

🤔 What to expect after submitting a PR

Once you open a pull request, here’s what happens next.

🤖 1. Automated checks
A small set of automated checks must pass before merging (signing, changelog, tests, examples, code quality).
Open any failed check to see details.

---

🤝 2. AI feedback (CodeRabbit)
CodeRabbit AI may suggest improvements or flag issues.
Feedback is advisory — use what’s relevant and helpful.

---

😎 3. Team review
A Python SDK team member reviews your PR within 1–3 days.
You may be asked to make changes or your PR may be approved.
Approved PRs are usually merged within one day.

🔄 Merge conflicts (sometimes)
Conflicts can happen and are normal as the SDK updates.
Changelog conflicts can be resolved online in the PR in the merge editor, accepting both entries
Others may require rebasing.

---

🤖 AI usage guidelines

Humans are welcome to use AI tools while working on this issue but we do not accept AI bot-authored PRs.

Use AI responsibly:

• review suggestions carefully
• apply changes incrementally
• test as you go

If in doubt, ask — maintainers are happy to help.

🤔 Additional Help

First Points of Contact:

• Discord
• Comment with @mentor_name (for Python SDK questions)
• Comment with @hiero-ledger/hiero-sdk-good-first-issue-support (for setup and workflow questions)
  The more you ask, the more you learn and so do we!

Documentation:

• README.md

• CONTRIBUTING.md

• Project Structure

• DCO and Verified Signing Guide

• Changelog Guide

• Rebasing Guide

• Merge Conflicts Guide

• Linking Issues Guide

• Workflow Guide

• Pin Github Actions Guide

• Running Examples

• Testing on Forks

• General Training

• General SDK Developer Docs

Calls:

• Get hands-on-help by our expert team at our Office Hours
• Learn, raise issues and provide feedback at Community Calls

[Roshan-Singh-07]

/assign

[github-actions]

👋 Hi @Roshan-Singh-07, welcome to the Hiero Python SDK community!

You've been assigned this Good First Issue. Your on-call mentor today from @hiero-ledger/hiero-sdk-python-triage is @undefinedIsMyLife, and the Good First Issue Support Team is @hiero-ledger/hiero-sdk-good-first-issue-support.
We’re here to help you get your first PR merged successfully 🚀

---

Step 1: Read the task

• Open the issue description, carefully read the requirements and workflow
• Read any linked documentation
• Make sure you understand the expected outcome
  If anything is unclear, ask your mentor before writing code.

---

Step 2: Tell us your plan (in this thread)

Reply here with:

• What you think the task is
• What you plan to change to solve the issue requirement and no more
• Any questions you have
  This means we can guide you early on, helping you to have a more stress free experience

---

Step 3: Get the right kind of help

Finishing your first PR can be really hard. We are here to help you - please ask us!

🛠 Good First Issue Support Team (@hiero-ledger/hiero-sdk-good-first-issue-support)
Use them for workflow and GitHub issues, such as:

• Failing CI checks
• Commit signing problems
• Merge conflicts
• Git/GitHub errors
  They can also jump on a call if needed.

🐍 Your Mentor (@undefinedIsMyLife)
Use your mentor for Python and code guidance, such as:

• Which files to edit
• How to structure your solution
• Docstring and code style questions
• Making sure your PR meets the issue requirements

💬 Discord (for fast help)
Guide: Join the Python SDK Discord
Use Discord when you need immediate answers from the community, like:

• What docs to read
• How to unblock yourself quickly
• Clarifying next steps in real time

---

Mentor: @undefinedIsMyLife
Mentee: @Roshan-Singh-07
If you're enjoying the SDK, consider ⭐️ starring the repository so it's easy to find later.
Happy building!
— Python SDK Team

[github-actions]

@coderabbitai plan

[coderabbitai]

Coding Plan

Summary

• Direct text replacement of runs-on: ubuntu-latest with runs-on: hl-sdk-py-lin-md across 6 occurrences in 4 workflow files
• No structural, formatting, or other content changes required
• Changes are isolated to the runs-on configuration value only

Implementation Steps

Update Workflow Runner Configuration

Update all GitHub Actions workflow files to use the self-hosted runner hl-sdk-py-lin-md instead of ubuntu-latest. This is a direct text replacement with no structural changes.

Task 1: Update Runner in Single-Job Workflow Files

Replace the runs-on value from ubuntu-latest to hl-sdk-py-lin-md in the three workflow files that each contain a single job.

• Update .github/workflows/deps-check.yml: Change runs-on: ubuntu-latest to runs-on: hl-sdk-py-lin-md in the min-deps job (line 17)
• Update .github/workflows/pr-check-examples.yml: Change runs-on: ubuntu-latest to runs-on: hl-sdk-py-lin-md in the run-examples job (line 14)
• Update .github/workflows/pr-check-test-files.yml: Change runs-on: ubuntu-latest to runs-on: hl-sdk-py-lin-md in the check-test-files job (line 17)

Task 2: Update Runner in Multi-Job Workflow File

Replace the runs-on value in all three jobs within pr-check-test.yml.

• Update .github/workflows/pr-check-test.yml: Change runs-on: ubuntu-latest to runs-on: hl-sdk-py-lin-md in the unit-tests job (line 30)
• Update .github/workflows/pr-check-test.yml: Change runs-on: ubuntu-latest to runs-on: hl-sdk-py-lin-md in the integration-tests job (line 90)
• Update .github/workflows/pr-check-test.yml: Change runs-on: ubuntu-latest to runs-on: hl-sdk-py-lin-md in the test-summary job (line 165)

🤖 Prompt for AI agents

Update GitHub Actions workflow files to replace all occurrences of `runs-on:
ubuntu-latest` with `runs-on: hl-sdk-py-lin-md`. No structural, formatting, or
other content changes should be made — only the `runs-on` value is modified.

**Single-job workflow files (one change each):**
- `.github/workflows/deps-check.yml`: replace `runs-on: ubuntu-latest` →
`runs-on: hl-sdk-py-lin-md` in the `min-deps` job (line 17)
- `.github/workflows/pr-check-examples.yml`: replace `runs-on: ubuntu-latest` →
`runs-on: hl-sdk-py-lin-md` in the `run-examples` job (line 14)
- `.github/workflows/pr-check-test-files.yml`: replace `runs-on: ubuntu-latest`
→ `runs-on: hl-sdk-py-lin-md` in the `check-test-files` job (line 17)

**Multi-job workflow file (three changes):**
- `.github/workflows/pr-check-test.yml`: replace `runs-on: ubuntu-latest` →
`runs-on: hl-sdk-py-lin-md` in:
  - `unit-tests` job (line 30)
  - `integration-tests` job (line 90)
  - `test-summary` job (line 165)

In total, 6 occurrences across 4 files must be updated.

Research

The repository contains GitHub Actions workflows in .github/workflows/. Four workflow files currently use ubuntu-latest as their runner and need updating. Three files (deps-check.yml, pr-check-examples.yml, pr-check-test-files.yml) each contain a single job with one runs-on setting. The fourth file (pr-check-test.yml) contains three jobs (unit-tests, integration-tests, test-summary), each with its own runs-on setting. In total, there are 6 occurrences of runs-on: ubuntu-latest that need to be changed.

---

🚀 Next Steps

🤖 All AI agent prompts combined

Update GitHub Actions workflow files to replace all occurrences of `runs-on:
ubuntu-latest` with `runs-on: hl-sdk-py-lin-md`. No structural, formatting, or
other content changes should be made — only the `runs-on` value is modified.

**Single-job workflow files (one change each):**
- `.github/workflows/deps-check.yml`: replace `runs-on: ubuntu-latest` →
`runs-on: hl-sdk-py-lin-md` in the `min-deps` job (line 17)
- `.github/workflows/pr-check-examples.yml`: replace `runs-on: ubuntu-latest` →
`runs-on: hl-sdk-py-lin-md` in the `run-examples` job (line 14)
- `.github/workflows/pr-check-test-files.yml`: replace `runs-on: ubuntu-latest`
→ `runs-on: hl-sdk-py-lin-md` in the `check-test-files` job (line 17)

**Multi-job workflow file (three changes):**
- `.github/workflows/pr-check-test.yml`: replace `runs-on: ubuntu-latest` →
`runs-on: hl-sdk-py-lin-md` in:
  - `unit-tests` job (line 30)
  - `integration-tests` job (line 90)
  - `test-summary` job (line 165)

In total, 6 occurrences across 4 files must be updated.

💡 Iterate on the plan with: @coderabbitai <feedback>

Example Feedback
- `@coderabbitai` You can skip phase 3. Add a simple unit test case for phase 2.
- `@coderabbitai` For design choice 1 go ahead with option 3 and replan.

---

💬 Have feedback or questions? Drop into our discord!