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.
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/civIQNeed more help?
Ask Sam directly — our AI assistant can answer questions about your election materials.