README.md

---
title: Cojournalist Data
emoji: 🏛️
colorFrom: blue
colorTo: purple
sdk: gradio
sdk_version: 5.49.1
app_file: app.py
pinned: false
short_description: Swiss Parliamentary Data Chatbot with Llama-3.1-8B
---

# 🏛️ CoJournalist Data

A Swiss Parliamentary Data Chatbot powered by Llama-3.1-8B-Instruct and the OpenParlData MCP server.

## Features

- 🤖 **Llama-3.1-8B-Instruct** - Meta's 8B parameter model with native tool calling support
- 🌍 **Multilingual** - Support for English, German, French, and Italian
- 🛠️ **Tool Calling** - Intelligent query routing to parliamentary data APIs
- 🔒 **Rate Limited** - 50 requests per day per user for cost control
- ⚡ **HF Inference Providers** - Fast inference via Novita and other providers

## Space Settings Required

**IMPORTANT:** To run this Space, configure the following:

### Environment Variables
- **Required:** `HF_TOKEN` - Your HuggingFace token with Inference Provider access
- Add this in Space Settings → Repository secrets

### Hardware
- **CPU Basic** (Free) - Sufficient since inference happens via API

## Usage

Simply ask questions about Swiss parliamentary data in natural language:
- "Who are the parliamentarians from Zurich?"
- "Show me recent votes about climate policy"
- "What motions were submitted about healthcare in 2024?"

## Architecture

- **Model:** meta-llama/Llama-3.1-8B-Instruct (8B params)
- **Inference:** HuggingFace Inference Providers (Novita, etc.)
- **Framework:** Gradio + HuggingFace Hub
- **MCP Integration:** OpenParlData server for parliamentary data

## Cost

- **HF PRO:** $9/month (recommended)
- **Inference:** $2/month included credits + pay-per-use
- **Estimated Total:** ~$12/month for typical usage (1,500 requests/month)
- **Space Hardware:** FREE (CPU Basic)

With 50 requests/day limit, costs stay predictable and affordable.

Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference