~95% on SimpleQA (e.g. Qwen3.6-27B on a 3090). Supports all local and cloud LLMs (llama.cpp, Ollama, Google, ...). 10+ search engines - arXiv, PubMed, your private documents. Everything Local & Encrypted.
News Subscriptions Guide
This guide covers the News Subscription system for automated research monitoring and news tracking.
Table of Contents
- Overview
- Creating Subscriptions
- Managing Subscriptions
- Update Frequency
- Subscription History
- Scheduler
- Notifications
- API Reference
Overview
News Subscriptions allow you to:
- Monitor topics with automatic periodic research
- Track search queries as living news feeds
- Get notifications when new content is found
- Organize subscriptions into folders
Access subscriptions at: http://localhost:5000/news/subscriptions
Subscription Types
| Type | Description | Use Case |
|---|---|---|
| Search | Recurring search query | "AI regulations news" |
| Topic | Topic monitoring with evolution tracking | "Machine Learning" |
Creating Subscriptions
From the Web UI
- Navigate to News → Subscriptions
- Click New Subscription
- Configure your subscription:
Basic Settings
| Field | Description |
|---|---|
| Query/Topic | What to search for |
| Name | Friendly name (optional) |
| Frequency | How often to update |
| Folder | Organization folder (optional) |
Research Settings
| Field | Default | Description |
|---|---|---|
| Model Provider | OLLAMA | LLM provider to use |
| Model | (varies) | Specific model |
| Search Engine | (your default search tool) | Search engine to use |
| Iterations | 3 | Research depth |
| Questions per Iteration | 5 | Breadth per cycle |
| Strategy | source-based | Research approach |
Submit Options
- Create & Run Now - Save and immediately execute
- Test Run - Test configuration without saving
- Create Subscription - Save for scheduled execution
From Research Results
When viewing research results, click Subscribe to create a subscription based on that query.
Managing Subscriptions
Dashboard Overview
The subscriptions dashboard shows:
| Metric | Description |
|---|---|
| Total | All subscriptions |
| Active | Currently running |
| Paused | Temporarily stopped |
| Updates Today | Refreshes in last 24h |
Subscription Actions
| Action | Description |
|---|---|
| Run Now | Execute immediately |
| Pause | Stop scheduled updates |
| Resume | Restart paused subscription |
| Edit | Modify settings |
| View History | See past research runs |
| Delete | Remove subscription |
Filtering & Search
- Search - Filter by name or query text
- Status - Show active, paused, or all
- Frequency - Filter by update interval
- Folder - Filter by organization folder
Folders
Organize subscriptions into folders:
- Click Manage Folders
- Create folders with names
- Assign subscriptions to folders
- Filter view by folder
Update Frequency
An interval you save, on a new subscription or an edit, must be a whole number of minutes from 1 to 10080 (one week).
Releases through 1.10.7 did not cap the interval and documented anything from 1 hour to 30 days, so a subscription they saved can be longer than a week. Those subscriptions keep running with the interval they have, up to 525600 minutes (365 days). The one-week limit applies when you edit one: saving a subscription sends its interval along with the other fields, so lower the interval to 10080 or less in the same save. Pausing and resuming from the subscriptions page does not send the interval and leaves it unchanged.
A saved interval that is not a whole number of minutes from 1 to 525600, such as 0, a negative number, a fraction or an empty value left by an import, is skipped by scheduled and overdue checks, and Run Now asks you to correct it. Edit the subscription and save a valid frequency to make it runnable again. The saved value is not silently changed.
Preset Intervals
| Frequency | Interval |
|---|---|
| Hourly | 60 minutes |
| Every 3 hours | 180 minutes |
| Every 6 hours | 360 minutes |
| Every 12 hours | 720 minutes |
| Daily | 1440 minutes |
| Weekly | 10080 minutes |
Custom Intervals
Set any interval from 1 to 10080 whole minutes (one week) when you create or edit a subscription.
Jitter
A small random delay (up to 5 minutes) is added to prevent all subscriptions from running simultaneously.
Subscription History
View the research history for any subscription:
- Click on a subscription
- Select View History
History Details
| Field | Description |
|---|---|
| Research Title | Query that was executed |
| Timestamp | When it ran |
| Status | Completed or failed |
| Duration | How long it took |
| Topics | Extracted topics |
Click on any research run to view full results.
Scheduler
The scheduler runs subscriptions automatically in the background.
Scheduler Status
The status bar shows:
- Whether scheduler is running
- Number of active jobs
- Whether your subscriptions are tracked
Starting the Scheduler
The scheduler starts automatically when you log in. Your session remains active for 48 hours.
Manual Control
- Run Now - Execute any subscription immediately
- Pause - Stop a subscription temporarily
- Resume - Restart a paused subscription
Error Handling
If a subscription fails:
- It retries with exponential backoff
- After 10 consecutive failures, it's automatically disabled
- You receive a notification about the error
- You can manually resume it anytime
Notifications
Get notified when subscriptions update or encounter errors.
Notification Events
| Event | Description |
|---|---|
| subscription_update | New content found |
| subscription_error | Update failed |
Setup
Configure notifications in Settings → Notifications:
- Add notification service URLs (Discord, Slack, Email, etc.)
- Enable subscription notifications
- Test your configuration
See NOTIFICATIONS.md for supported services.
API Reference
Subscription Endpoints
| Endpoint | Method | Description |
|---|---|---|
/news/api/subscriptions |
GET | List all subscriptions |
/news/api/subscriptions |
POST | Create subscription |
/news/api/subscriptions/<id> |
GET | Get subscription details |
/news/api/subscriptions/<id> |
PUT | Update subscription |
/news/api/subscriptions/<id> |
DELETE | Delete subscription |
/news/api/subscriptions/<id>/run |
POST | Run with saved settings; reject an invalid saved interval |
/news/api/subscriptions/<id>/history |
GET | Get subscription history |
Folder Endpoints
| Endpoint | Method | Description |
|---|---|---|
/news/api/subscription/folders |
GET | List folders |
/news/api/subscription/folders |
POST | Create folder |
Scheduler Endpoints
| Endpoint | Method | Description |
|---|---|---|
/news/api/scheduler/status |
GET | Get scheduler status |
/news/api/scheduler/start |
POST | Start scheduler |
Example: Create Subscription
import requests
response = requests.post(
"http://localhost:5000/news/api/subscriptions",
json={
"query": "AI safety news",
"name": "AI Safety Updates",
"refresh_minutes": 1440, # Daily
"model_provider": "ollama",
"search_engine": "searxng",
"iterations": 3
},
cookies={"session": your_session_cookie}
)
Troubleshooting
Subscription Not Updating
- Check scheduler status (should be "Running")
- Verify subscription is not paused
- Check for errors in subscription history
- Try "Run Now" to test manually
Too Many Updates
- Increase the update frequency (e.g., daily instead of hourly)
- Pause subscriptions you don't need actively
Missing Notifications
- Verify notification service is configured
- Test notification URL in settings
- Check subscription notification events are enabled
Scheduler Not Starting
- Log out and log back in
- Check browser console for errors
- Verify server is running
See Also
- NOTIFICATIONS.md - Notification service setup
- Full Configuration Reference - All settings, defaults, and environment variables
- API Quickstart - API authentication
- Features - Feature overview