Your AI news analyst that reads everything, briefs you on what matters, and helps you create content from it.
Morning Deck is an open-source, self-hostable AI-powered news intelligence platform. It aggregates content from diverse sources (RSS, newsletters, websites, Reddit), scores and organizes it against your interests, and delivers personalized daily briefings. Beyond consumption, it helps you transform curated news into blog posts and social media content that matches your voice and style.
- Multi-source aggregation — RSS feeds, email newsletters, web scraping, Reddit
- AI-powered scoring — Content ranked by relevance to your defined interests
- Daily briefings — Scheduled summaries delivered via web or email
- Content creation — Generate posts for LinkedIn, Twitter/X, blogs in your voice
- Writer profiles — Define multiple voices for different platforms and contexts
- Full-text search — Find anything you've ever read
- Self-hostable — Own your data, use any OpenAI-compatible LLM
Get Morning Deck running in 3 commands:
# 1. Download the compose file
curl -O https://raw.githubusercontent.com/eschnou/morningdeck/main/docker-compose.quickstart.yml
# 2. Create your .env file with your OpenAI key
echo "OPENAI_API_KEY=your-key-here" > .env
# 3. Start the stack
docker compose -f docker-compose.quickstart.yml up -dOpen http://localhost:8080 in your browser. That's it.
Note: Images are available for both
linux/amd64andlinux/arm64. For advanced configuration (alternative LLM providers, Meilisearch, etc.), see Self-Hosting below.
For production deployments or advanced configuration, clone the repository:
git clone https://github.com/eschnou/morningdeck.git
cd morningdeck
cp .env.selfhost.example .env
# Edit .env with your settings
docker compose -f docker-compose.selfhost.yml up -dAll settings are in .env. The essential ones:
# Required: Your OpenAI API key
OPENAI_API_KEY=sk-...
# Optional: Use alternative LLM providers
OPENAI_BASE_URL=https://api.openai.com # Default
# OPENAI_BASE_URL=https://openrouter.ai/api/v1
# OPENAI_BASE_URL=http://host.docker.internal:11434/v1 # Ollama
# Optional: Choose your models
OPENAI_MODEL_LITE=gpt-4o-mini # For summaries, categorization
OPENAI_MODEL_HEAVY=gpt-4o # For briefing generationSee .env.selfhost.example for all available options.
Morning Deck works with any OpenAI-compatible API out of the box:
| Provider | Base URL | Notes |
|---|---|---|
| OpenAI | https://api.openai.com |
Default |
| OpenRouter | https://openrouter.ai/api/v1 |
Access to many models |
| Ollama | http://host.docker.internal:11434/v1 |
Local, private |
| Groq | https://api.groq.com/openai |
Fast inference |
Want to use other providers? Morning Deck is built on Spring AI, which supports many more providers natively (Anthropic, Azure OpenAI, Google Vertex AI, Amazon Bedrock, Mistral, and more). Adding support for these requires minor code changes — see the Spring AI documentation for details.
- Java 21
- Node.js 20+
- Docker & Docker Compose
- Maven
# Start PostgreSQL (and optionally Meilisearch for search)
docker compose up -d
# Backend (runs on port 3000)
cd backend
mvn spring-boot:run -Dspring-boot.run.arguments="--spring.profiles.active=local"
# Frontend (runs on port 5173)
cd frontend
npm install
npm run dev├── backend/ # Spring Boot API (Java 21)
├── frontend/ # React SPA (TypeScript, Vite, Tailwind)
├── documentation/ # Technical documentation
├── specs/ # Product specifications
└── docker-compose.yml # Local development services
Backend: Spring Boot 3, Spring AI, PostgreSQL, Flyway, Meilisearch (optional)
Frontend: React 18, TypeScript, Vite, Tailwind CSS, shadcn/ui, React Query
- Website: morningdeck.com
- Discord: Join our community
- Issues: GitHub Issues
Morning Deck is open source software licensed under the GNU Affero General Public License v3.0 (AGPL-3.0).
This means you can use, modify, and distribute the software, but if you run a modified version as a network service, you must make the source code available to users of that service.