DáilDex’s backend is now public on GitHub under the MIT licence. You can read the code, run it on your own computer, change it and contribute improvements. The repository includes the API, data ingestion, background workers and database migrations, with a local setup guide.
Why we’re opening the code
We built DáilDex around a simple idea: follow your local TDs and get an email when they vote, speak or ask a parliamentary question. Each alert links to the official Oireachtas record so you can read the source yourself. Most people do not have time to check that record each day. We want to make following it easier.
People should be able to inspect how a service about public accountability works. Publishing the backend lets developers examine how we fetch records, attribute activity to representatives, manage alert queues and handle source links. It also gives people a way to point out a problem with a specific piece of code and propose a fix.
You can also use this work to build your own tools. A researcher might want a local parliamentary database. A community group might want a different alert format. Someone else might build an interface we would never have thought of. The MIT licence allows reuse and modification, subject to retaining its licence notice.
What we’ve released
The repository contains the Node.js API, a public read-only MCP endpoint, Oireachtas ingestion jobs, PostgreSQL migrations, shared schemas and backend services, plus workers for email delivery, alerts, replies and other background tasks. Tests and example configuration are included.
This is a backend release. It does not include the hosted website or Dex chat interface. It contains the subscription services and email pipeline, which you can connect to your own frontend. Private chats, subscriber records, our production database and credentials are not part of the release. The source parliamentary records retain their own terms and attribution requirements.
Our commitment to free features
We are committed to keeping most DáilDex features free, including the core service: following representatives and receiving alerts about their parliamentary activity. The Learn guides, access to the official record through our public API within its published limits, and the standard free Dex allowance are also available without Pro.
Dex Pro is optional. It offers additional tools, higher limits and access to more expensive models. It is one way to help pay for the project. You should be able to follow your representatives and check the record without buying it. We will explain which features are free and which require Pro before asking anyone to subscribe.
We’re still self funding DáilDex
We are still putting our own money into building and running DáilDex. Hosting, email delivery, model calls and ongoing development all have costs. Pro is intended to help cover those costs and support the free service. Opening the backend also lets people run their own instance using their own infrastructure.
We want the project to be useful enough that people choose to support it. We are committing to preserve the free core and keep most features accessible as we develop it.
The record comes first
We have removed parliamentary question drafting from Dex and its promotion. The service can still help you find and understand existing questions and ministerial answers. Our focus is helping people follow parliamentary activity and inspect the evidence behind it.
AI explanations can contain errors, including incorrect citations. Publishing code gives people more ways to examine our approach; readers should still check the original record. We are also replacing claims that imply an AI system cannot make mistakes with clearer descriptions of its limits.
Run the backend locally
Anyone with Node.js 22 and PostgreSQL 16 or newer can run the record API locally. The repository also includes Docker Compose to start a local database. With Git, Node and Docker installed, the quick start is:
git clone https://github.com/repath500/daildex-backend.git
cd daildex-backend
npm ci
npm run setup:local
docker compose up -d --wait
npm run db:migrate
npm run ingest:members
npm run devThe API runs at http://127.0.0.1:8787, with its reference at /docs. The setup command creates local configuration with fresh tokens, migrations create the database tables, and the ingestion job imports representatives from the official Oireachtas API. You can then import votes, debates, existing questions and legislation using the commands in the README.
You do not need a DáilDex subscription or an AI account to run the record API and ingestion. Sending emails requires your own email provider and domain. AI drafting workflows require your own compatible agent and model setup. Those services may cost money. The sample configuration starts with sending and model generation disabled; the README explains the additional setup.
Help improve it
The repository accepts issues and pull requests. You can help with source attribution, ingestion bugs, local setup instructions, tests or new ways to use the public record. When reporting a factual error, include the official source and an example we can reproduce. The repository also explains how to report security issues privately.