Projects / Agno AI Framework - Hello World PoC

Agno AI Framework - Hello World PoC

A beginner-friendly Hello World for the Agno AI framework: one Agno agent with an OpenAI chat model, in a Poetry-managed Python environment with setup scripts for Windows, macOS and Linux.

Version: 1.0.1 stable
Released: 2026-10-11
Runtime: Python 3.11
Project ID: agno-hello-world-poc

Download version 1.0.1 Report an issue

The download opens the Qubot download page, which creates a link valid for 15 minutes.

SHA256 c15ed87339c8bb95873ba85dfefd6cbd0c323feca2293c3423a0c9ecb871309b

Release notes

Version 1.0.1 stable

Released 2026-10-11 · commit c80e95e

Fixed: an empty or whitespace-only AGNO_PROMPT in .env is now treated as not set, so the default prompt is used instead of sending an empty prompt to the agent.
Added tests for the prompt handling (poetry run pytest).

SHA256 c15ed87339c8bb95873ba85dfefd6cbd0c323feca2293c3423a0c9ecb871309b

Download agno-hello-world-poc-v1.0.1.zip

Version 1.0.0

Released 2026-10-10 · commit 78158c4

Initial release.

SHA256 b10f145d9a0dbdf8caffd249100ea64bb840f5ac3617034ff4b0815a157d3055

Download agno-hello-world-poc-v1.0.0.zip

Check your setup

Every release includes a diagnostics script. Run it in the extracted project folder:

python scripts/diagnose.py

For a Poetry project, run poetry run python scripts/diagnose.py so it checks the project's own environment. It prints PASS or FAIL for the Python version, the .env file, the dependencies and the required tools, and writes qubot-diagnostics.json. That file contains versions and results only, never the values of your settings.

Which version do you have? Open qubot.json in the project folder.

To check your download, compare its SHA256 with the value above: Get-FileHash .\agno-hello-world-poc-v1.0.1.zip -Algorithm SHA256 on Windows, or shasum -a 256 agno-hello-world-poc-v1.0.1.zip on macOS and Linux.

Known issues

Empty AGNO_PROMPT sends an empty prompt (KNOWN-0006)

Affects version 1.0.0. Fixed in 1.0.1.

With AGNO_PROMPT= left empty in .env, the agent is called with an empty prompt instead of the default one and prints an unhelpful or empty answer.

What to do: Download version 1.0.1 or later, which treats an empty or whitespace-only AGNO_PROMPT as not set. On 1.0.0, remove the AGNO_PROMPT line from .env or give it a real prompt.

Common setup problems

Download link expired: Go back to the project page on qubotaitech.com, open the download page again and start the download within 15 minutes.
Download page says the asset was not found: Open the project page on qubotaitech.com and use its Download button, which always points at the current stable version.
Wrong Python version: Install the Python version listed in qubot.json, create a new virtual environment with it, reinstall the dependencies, then run python scripts/diagnose.py to confirm python_version is PASS.
Environment file missing or incomplete: Copy .env.example to .env in the project folder and fill in every variable. Run python scripts/diagnose.py; the environment_file check lists the variable names that are missing. Never send the .env file itself to support.
Dependencies not installed in the active environment: Activate the project's virtual environment, run pip install -r requirements.txt (or poetry install if the project has a pyproject.toml and no requirements.txt), then run python scripts/diagnose.py to confirm dependencies is PASS.

Support

If the steps above do not solve it, report an issue and attach qubot-diagnostics.json. You will get an issue ID, which you can look up at any time.