datasources

Datasources

This directory contains documentation for individual datasources available in Ergs. Each datasource has its own configuration options and behavior.

Available Datasources

Browser Data

• Firefox - Extract browsing history from Firefox's places.sqlite database
• Chromium - Extract browsing history from Chromium's History database (works with Chrome, Edge, Brave, etc.)

Code Hosting Platforms

• GitHub - Fetch GitHub activity, events, and repository interactions
• Codeberg - Fetch Codeberg activity and repository events

Development Tools

• Zed Threads - Extract AI conversation threads from Zed editor

Home & Utilities

• Home Assistant - Capture Home Assistant events (state changes, service calls, automations) via the WebSocket API
• Datadis - Fetch electricity consumption data from Datadis (Spanish electricity data platform)
• Gas Stations - Fetch current fuel prices from Spanish gas stations

Weather

• Open-Meteo - Fetch current weather data for any location worldwide (free, no API key required)

News & Content

• Hacker News - Fetch stories, comments, and other items from Hacker News
• RSS - Fetch articles from RSS/Atom feeds
• RTVE - Fetch episodes from RTVE (Spanish TV) shows

General Usage

All datasources follow the same configuration pattern in your config.toml:

[datasources.my-datasource-name]
type = 'datasource_type'

[datasources.my-datasource-name.config]
# datasource-specific configuration options

Common Commands

Once configured, all datasources work with the same ergs commands:

# List configured datasources
ergs datasource list

# Fetch data from all datasources
ergs fetch

# Fetch from specific datasource
ergs fetch --datasource my-datasource-name

# Search across all data
ergs search --query "search terms"

# List recent data from a datasource
ergs list --datasource my-datasource-name --limit 10

# View statistics
ergs stats

Development

For information on creating new datasources, see the main Datasource Development Guide.