返回资讯中心
外部精选
软件工程
#开发者实时流

Show HN: AI Gude - Personal Podcast News Aggregator

You want to generate a podcast every morning with the latest news from your favourite news pages? Just drop the RSS feed into AI Gude and get your custom podcast every morning.

Hacker News 最新baquero2026/11/10 · 7 天前25 分钟阅读

以下正文同步自 Hacker News 最新,版权归原站所有,已转换为易读排版。

Ei Gude is Hessian for good morning, and AI Gude sounds just like it. It is your own morning podcast.

You choose the news sources you follow and how the show should sound. At the times you pick, AI Gude 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 listening on your phone.

You host it yourself. AI Gude is free and open source software.

Live demo: aigude.alexdoes.dev. Sign in with the user demo and the password demo. You can browse the Episodes and play them. You cannot switch users, produce, retry or delete Episodes, and the log, the editor of the User Config and the problems of its files stay closed.

Getting Started

Concepts

How AI Gude works

Operating modes

How-Tos

License

Getting Started

In this tutorial you start AI Gude on your machine and listen to your first Episode.

git clone https://github.com/alex0ptr/aigude.git cd aigude

Install the tools with mise, which has to be activated in your shell. It installs the versions of Go, ffmpeg and task that the project pins.

mise install

Get a key at Google AI Studio for the language model and the voice, and one at Firecrawl for reading the articles. Export both.

export GEMINI_API_KEY="..." export FIRECRAWL_API_KEY="..."

Start the service with the example configuration in hack/.

task serve:hosted

It can be reached from your network, so run it on a network you trust.

Open http://localhost:8080, choose the show and press "Generate now". Producing the Episode takes a few minutes. When it is done it appears in the list. Press play.

You have a running AI Gude. To follow your own feeds, continue with Configure Shows, Feeds and Schedules.

How AI Gude works

A User owns CastProfiles, and each CastProfile is a show. A CastProfile lists the Subscriptions it draws Content from, which are RSS feeds, a Max Lookback that says how old Content may be, and Schedules that say when an Episode is made. Content is one item that a Subscription delivers, such as an article. An Episode is one audio file with its Script and its Chapters, one Chapter for each Section of the Script.

The core flow, from a Schedule to a finished Episode:

sequenceDiagram autonumber participant S as Scheduler participant W as Worker participant DB as Database participant R as RSS feeds participant C as Crawler participant G as Gemini participant F as ffmpeg

S->>W: Schedule is due, queue the CastProfile Note over S,W: "Generate now" queues the same request W->>DB: Which Content was used by this CastProfile already? W->>R: Fetch the Subscriptions, Content within the Max Lookback R->>C: Retrieve the full text of each new article C-->>R: Cleaned text, from the cache while it is fresh R-->>W: Contents alt nothing new W-->>S: No Episode, only a log line else new Content W->>G: Rules, style guide and numbered Contents G-->>W: Script with title and Sections loop every Section W->>G: Speak the Section G-->>W: Speech as PCM end W->>F: Speech joined with a pause between Sections F-->>W: One OGG/Opus file W->>W: Write the Chapters into the file W->>DB: Save Episode, Script, Chapters, sources and usage end Note over W,DB: Any failure saves the Episode as failed, with its reason

Loading

What to keep in mind:

Behind the steps are small interfaces, and one adapter each does the work today:

flowchart LR P["Episode production"] P --> CR["ContentRepository"] --> RSS["RSS feeds"] P --> CW["Crawler"] --> FC["Firecrawl"] P --> SW["ScriptWriter"] --> GM["Gemini text"] P --> TT["TTS"] --> GT["Gemini speech"] P --> AE["AudioEncoder"] --> FF["ffmpeg"] P --> ER["EpisodeRepository"] --> DB["SQLite"] P --> AS["AudioStore"] --> FS["Files"]

Loading

Operating modes

The only part you can run in two ways is the Crawler, which retrieves the full text of the articles. You choose it with the setting firecrawl_url.

AI Gude keeps crawled pages for crawl_cache_ttl, which is ten days by default, and shares them between all Users. An article that is retrieved again soon costs nothing.

Configure the Service Settings

Settings apply to the whole service. The commented example is hack/aigude.toml.

Shows, feeds and Schedules belong to a User and live in that User's file. The commented example is hack/users/demo.toml, and it is the template for new Users.

aigude validate --users-dir users

Configure Multiple Users and Authentication

AI Gude has no sign-in of its own. Authentication is the job of a reverse proxy in front of it. The proxy tells AI Gude who is asking in a request header, and from then on each person works in their own User and cannot reach another one.

Without the header everyone who reaches the port can switch between all Users in the interface, produce and delete Episodes and edit every User Config. At home on a network you trust that is a fine way to share one instance. It is also why the service listens on 127.0.0.1 by default. Do not leave it like this on a network that others can reach.

To add a User, copy hack/users/demo.toml into the users folder and change the [user] table and what follows. The file is picked up at once.

After the proxy has authenticated a person, it sets the header X-Aigude-User to the Id of their User. Use the Id and not the display name, because only the Id never changes.

A request with this header belongs to that User. The interface offers no switch to another User, a request to switch is refused, and the person sees only their own Episodes and edits only their own User Config. A header that is empty, that names no User or that names a User without a valid setup is answered with 403 for every request.

Two things have to hold for this to be safe:

Traefik asks for a user name and a password and writes the name into X-Aigude-User. So the user name of the Basic Auth is the Id of the User. Create the users file with one line for each person, for example with htpasswd:

htpasswd -nB alex >> /etc/traefik/users

Then add the route and its middleware to the dynamic configuration of Traefik. Replace the host name and the address of the service. The example assumes an entry point websecure and a certificate resolver letsencrypt. Serve it over HTTPS, because Basic Auth sends the password with every request.

http: routers: aigude: rule: Host(aigude.example.org) entryPoints:

  • websecure service: aigude middlewares:
  • aigude-auth tls: certResolver: letsencrypt

middlewares: aigude-auth: basicAuth: usersFile: /etc/traefik/users realm: AI Gude headerField: X-Aigude-User removeHeader: true

services: aigude: loadBalancer: servers:

headerField makes Traefik set X-Aigude-User from the user name and replaces a value that the client sent, and removeHeader keeps the credentials from reaching AI Gude. A name in the users file that is not a User of AI Gude is answered with 403.

The User with the Id demo is shown in Demo Mode. Whoever looks at its pages can browse and play its Episodes, and nothing can be changed. The log and the editor of the User Config are closed, and the interface leaves out what only the person running the service should see, such as problems in the User Config files. Because "Generate now" is closed too, the Episodes of the demo User come from its Schedules. Create it like any User, for example from the sample hack/users/demo.toml with the Id demo.

Produce an Episode with "Generate now" on a CastProfile, or let its Schedules do it.

Episodes are deleted with their audio once they are older than the Retention, the time Episodes are kept. The setting is episode_retention, it is 30 days by default, it counts from the creation of the Episode and it applies to failed Episodes too. 0 keeps them for ever. The check runs at the start and once a day, and a deleted Episode gives its Content back.

The meter on an Episode shows what it consumed, such as tokens and crawled pages.

GET /healthz answers 200 with ok and checks nothing behind it, not the database, not Gemini and not Firecrawl. It needs no headers of a proxy.

Back up the data folder data_dir. It holds the SQLite database and the audio files. The User Config files are the only copy of your configuration.

Install AI Gude on a Linux VM

The whole Ansible part is vibe coded. An AI assistant wrote the collection. The roles were run on a host and worked, but nobody has reviewed the code. Be especially careful. Read the roles before you run them, try them with ansible-playbook --check first, and use a host that you can set up again. The only automatic check is ansible-lint.

The Ansible collection alex0ptr.aigude installs AI Gude on a Linux host with rootful Podman, as systemd quadlets. It can also install Traefik with HTTPS and a sign-in in front of it, and a Firecrawl of your own. The host needs Ubuntu 24.04, Debian 13 or another system with Podman 4.8 or newer.

Add the collection to the requirements.yml of your Ansible project and install it:

collections:

ansible-galaxy collection install -r requirements.yml

Copy the example playbook that fits from deploy/ansible_collections/alex0ptr/aigude/playbooks/. There is one for each combination of no proxy or Traefik, and the hosted Firecrawl or one of your own.

Set your host group and your values in it. The Gemini key and the address of the Firecrawl are the least it needs.

Without a proxy AI Gude then listens on 127.0.0.1:8080 of the host. The README of the collection lists the variables and says what to know about the image, the networks and the firewall.

AI Gude is licensed under the GNU Affero General Public License, version 3 or later. See LICENSE.

正文由 探How 从来源站点 RSS 同步,内容未经改写;遇到排版缺失或需要图片、视频时请以原文为准。

打开原文
去社区讨论 →