Help Center

Find answers and get the most out of CivIQ.

Quick Links

Frequently Asked Questions

Getting Started

CivIQ is an AI-powered election management platform for county officials. It helps manage training documents, recruit poll workers from voter registration data, and provides an AI assistant (Sam) trained on your election materials.
Start by uploading your training documents in the Documents tab. Then use the AI Center to test Sam's responses, and the Recruit tab to find poll worker candidates.
Training documents should be uploaded as PDF files. The system will automatically parse, chunk, and index them for AI retrieval. Each document is split into sections for precise source attribution.

Poll Worker Recruitment

Candidates are scored on a 0-100 scale based on multiple factors: previous poll worker experience, bilingual ability, years of voter registration (civic engagement), age, and availability. Higher scores indicate stronger candidates.
Required columns: id, first_name, last_name, age, city, precinct, languages, registered_since, previous_poll_worker, availability. Optional columns: address, zip, party, email, phone.
The system uses rigorous eligibility criteria to surface the most qualified candidates. Voters must meet age requirements (25-68), have 3+ years of registration, and demonstrate at least two qualifying signals such as bilingual ability, previous experience, or long-term civic engagement.
Yes. Click "Re-upload CSV" in the Recruit tab header. This takes you to the full upload screen where you can start fresh with a new or updated file. The previous results will be replaced.

AI Assistant (Sam)

Sam answers questions based on your uploaded training documents. It can help with poll worker procedures, voter check-in protocols, equipment setup, accessibility requirements, and any topic covered in your materials.
Yes. Sam supports both English and Spanish. You can toggle the language in the chat interface, and Sam will respond in the selected language while still referencing your English-language documents.
If the local Ollama server is unavailable, Sam automatically falls back to Groq cloud API. This ensures uninterrupted service. You can check service status in Settings.
Sam uses Retrieval-Augmented Generation (RAG) — it retrieves relevant sections from your actual documents before generating answers. Every response includes source attribution so you can verify the information.

Documents & Data

Go to Documents to upload, view, activate, or deactivate training materials. Only active documents are used by Sam for answering questions.
Yes. All document processing, vector indexing, and candidate scoring happen locally through the RAG sidecar. No data is sent to external servers unless Groq cloud fallback is triggered for AI responses.
Yes. Use the "Export All" button or select specific candidates and export them from the Recruit tab. Data is exported as a CSV file with all candidate details and scores.

Source Code

CivIQ is open source. View the full codebase, report issues, or contribute on GitHub.

github.com/SankrityaT/civIQ

Need more help?

Ask Sam directly — our AI assistant can answer questions about your election materials.

Ask Sam