AI Gude

Your own morning podcast from the news sources you follow, narrated by AI.

  • ghcr.io/hsinghhira/aigude:latest
  • v0.1.0
  • Updated 10 Nov 2026
  • port 6724
  • amd64 · arm64
  • AI
  • 7 stars

Screenshots

AI Gude screenshot 1: An Episode

Open the app

Web App

http://localhost:6724/

About AI Gude

AI Gude is your own morning podcast. You choose the news sources you follow and how the show should sound; at the times you pick, it reads what is new, writes a script in your style, speaks it with an AI voice and delivers one audio Episode with chapters, made for your phone.

Features

  • Shows built from your RSS feeds, with their own language, voice and style
  • Schedules: an Episode every morning, or whenever you like
  • Episodes with chapters and a list of what each one used
  • Gemini writes and speaks; Firecrawl reads the articles
  • Several users, each with their own shows

How to use

  1. Add your GEMINI_API_KEY and FIRECRAWL_API_KEY before you install.
  2. Open AI Gude, pick the sample show and press Generate now.
  3. Edit your shows and feeds on the config page (or in me.toml).

Before you install

AI Gude needs a Google AI Studio key in GEMINI_API_KEY (script and voice) and a Firecrawl key in FIRECRAWL_API_KEY (reading articles), unless you run your own Firecrawl. It has no sign-in: keep it on your home network, or behind a proxy that sets the X-Aigude-User header, and never open its port to the internet.

On the first start upstream's sample show is put in /DATA/AppData/aigude/users/me.toml; change it on the config page or in that file (changes are picked up at once). Every service setting is AIGUDE_ plus the key from upstream's hack/aigude.toml; the common ones are in the Variables tab.

The settings in the first table are already in the app settings. To use any other one, open the app settings, add the variable with your value, save, and the app restarts with it. A setting you leave out uses its default.

In the app settings

VariableDefault valueDescription
TZ$TZYour time zone. It is filled in from your ZimaOS time zone.
GEMINI_API_KEY—Required for Episodes. A Google AI Studio key (aistudio.google.com/apikey), for writing the script and the voice.
FIRECRAWL_API_KEY—A Firecrawl key (firecrawl.dev) for reading the articles. Not needed with a Firecrawl of your own (AIGUDE_FIRECRAWL_URL).

Service

VariableDefault valueDescription
AIGUDE_FIRECRAWL_URLhttps://api.firecrawl.devA Firecrawl of your own, like http://192.168.1.20:3002; the key is then optional.
AIGUDE_WORD_BUDGET1400Words per Episode when a show sets none; 1400 words are about ten minutes.
AIGUDE_SCRIPT_MODELgemini-flash-latestThe Gemini model that writes the script.
AIGUDE_TTS_MODELgemini-3.8-flash-ttsThe Gemini model that speaks it.
AIGUDE_CRAWL_CACHE_TTL240hHow long a read article is kept before it is read again.
docker-compose.yml
name: aigude

services:
  aigude:
    image: ghcr.io/hsinghhira/aigude:latest
    container_name: aigude
    restart: unless-stopped
    stop_grace_period: 30s
    network_mode: bridge
    environment:
      - TZ=$TZ
      - GEMINI_API_KEY=
      - FIRECRAWL_API_KEY=
    ports:
      - target: 8080
        published: "6724"
        protocol: tcp
    volumes:
      - type: bind
        source: /DATA/AppData/$AppID/users
        target: /etc/aigude/users
        bind:
          create_host_path: true
      - type: bind
        source: /DATA/AppData/$AppID/data
        target: /var/lib/aigude/data
        bind:
          create_host_path: true
    healthcheck:
      test: ["CMD", "wget", "-q", "-O", "/dev/null", "http://127.0.0.1:8080/healthz"]
      interval: 30s
      timeout: 5s
      retries: 3
      start_period: 20s
    deploy:
      resources:
        limits:
          cpus: "1.00"
          memory: 512M
        reservations:
          cpus: "0.00"
          memory: 32M
    labels:
      icon: https://cdn.jsdelivr.net/gh/HSinghHira/IceStore@main/Apps/aigude/icon.png
    x-casaos:
      id: com.icestore.aigude
      envs:
        - container: TZ
          description:
            en_US: >-
              Your time zone. It is filled in from your ZimaOS time zone.
        - container: GEMINI_API_KEY
          description:
            en_US: >-
              Required for Episodes. A Google AI Studio key
              (aistudio.google.com/apikey), for writing the script and the
              voice.
        - container: FIRECRAWL_API_KEY
          description:
            en_US: >-
              A Firecrawl key (firecrawl.dev) for reading the articles. Not
              needed with a Firecrawl of your own (AIGUDE_FIRECRAWL_URL).
      ports:
        - container: "8080"
          description:
            en_US: AI Gude web app, published on host as 6724
      volumes:
        - container: /etc/aigude/users
          description:
            en_US: >-
              One .toml file per user with their shows, feeds and schedules. A
              sample (me.toml) is put here on the first start.
        - container: /var/lib/aigude/data
          description:
            en_US: The database, the Episodes' audio and the article cache.

x-casaos:
  id: com.icestore.aigude
  architectures:
    - amd64
    - arm64
  main: aigude
  author: HSinghHira
  category: AI
  developer: alex0ptr
  icon: https://cdn.jsdelivr.net/gh/HSinghHira/IceStore@main/Apps/aigude/icon.png
  thumbnail: https://cdn.jsdelivr.net/gh/HSinghHira/IceStore@main/Apps/aigude/screenshot-1.jpg
  screenshot_link:
    - https://cdn.jsdelivr.net/gh/HSinghHira/IceStore@main/Apps/aigude/screenshot-1.jpg
  title:
    en_US: AI Gude
  tagline:
    en_US: Your own morning podcast from the news sources you follow, narrated by AI.
  description:
    en_US: >-
      Visit: [https://icestore.hsinghhira.me/app/aigude/](https://icestore.hsinghhira.me/app/aigude/) for full details


      AI Gude is your own morning podcast. You choose the news sources you
      follow and how the show should sound; at the times you pick, it reads
      what is new, writes a script in your style, speaks it with an AI voice
      and delivers one audio Episode with chapters, made for your phone.


      **Features**


      - Shows built from your RSS feeds, with their own language, voice and
        style

      - Schedules: an Episode every morning, or whenever you like

      - Episodes with chapters and a list of what each one used

      - Gemini writes and speaks; Firecrawl reads the articles

      - Several users, each with their own shows


      **How to use?**


      1. Add your GEMINI_API_KEY and FIRECRAWL_API_KEY before you install.


      2. Open AI Gude, pick the sample show and press Generate now.


      3. Edit your shows and feeds on the config page (or in me.toml).
  tips:
    before_install:
      en_US: >-
        1. Get a key at Google AI Studio (aistudio.google.com/apikey) and one
           at Firecrawl (firecrawl.dev). Put them in GEMINI_API_KEY and
           FIRECRAWL_API_KEY.


        2. AI Gude has no sign-in. Keep it on your home network, and never
           open its port to the internet.


        3. Start the installation. It is ready in a few seconds.


        4. Open AI Gude and press Generate now. The first Episode takes a few
           minutes.


        5. A sample show is put in place on the first start. Change it on
           the config page, or in AppData, aigude, users, me.toml.
  index: /
  port_map: "6724"
  scheme: http
  is_uncontrolled: false
  version: "0.1.0"
  update_at: "2026-11-10"
  release_notes:
    en_US: |-
      - First IceStore version: AI Gude 0.1.0 (the release binary; upstream publishes no image) with ffmpeg 9.0.2, built the way upstream's Dockerfile is.
      - Port 6724. Upstream's sample show is put in the users folder on the first start.
  repo: "https://github.com/alex0ptr/aigude"
  support: "https://github.com/alex0ptr/aigude/issues"
  docs: "https://github.com/alex0ptr/aigude#readme"

Install AI Gude

Something not working with AI Gude?

Report it so it gets fixed, or ask for an app that is not here yet.

More AI apps

See all