DEV Community: Arnab Roy

BillSathi: Proof Before Trust — Autonomous Financial Document Intelligence for Freelancers & Micro-Agencies

Arnab Roy — Wed, 14 Oct 2026 20:36:03 +0000

This is a submission for the Hacktoberfest Open-Source AI Challenge Week 2: Side Hustle

What I Built

Most AI invoice extractors act as black-box transcription bots: they blindly parse text and hallucinate numbers. When an invoice contains misprinted figures, hidden surcharges, or accidental duplicate submissions, generic chatbots transcribe them as cold facts. Come tax time or audit season, freelancers and micro-agencies lose billable hours manually digging through piles of PDFs to double-check their spreadsheets.

BillSathi ("Your Bill Companion") turns document extraction into an audit-grade financial operating system built on the principle: Proof Before Trust.

Who Would Pay For It?

Solo Freelancers & Consultants: Spending 4–8 unbillable hours each month cross-checking vendor receipts, tracking currency differences, and preparing accountant handoffs.
Micro-Agencies & Studios: Managing multiple concurrent client accounts with recurring software subscriptions, fluctuating contractor fees, and strict audit compliance.

Proposed Commercial Model (Side Hustle Hypothesis)

Solo Freelancer ($9/month): Up to 50 documents/month, spatial evidence linking, live currency ledger, RFC 4180 accountant CSV export.
Micro-Agency ($29/month): Up to 250 documents/month, vendor spending drift intelligence, multi-workspace client profiles, and batch intake.
Self-Hosted Community (Free Apache-2.0): 100% free forever for air-gapped local deployments with zero cloud dependencies.

Key Product Capabilities

Interactive Spatial Evidence Workspace: Every extracted number is spatially tied to real physical vector coordinates on the source document canvas. Clicking any field draws an elevated green bounding box over the exact source proof. We never invent or hallucinate coordinates.
Deterministic Mathematical Authority: AI handles semantic categorization; pure integer-cents arithmetic (Subtotal + Tax == Total) enforces mathematical truth. AI is never the mathematical authority.
Deterministic Anomaly & Duplicate Gate: Catches arithmetic discrepancies (e.g. Subtotal $800 + Tax $100 vs. printed $950), flags duplicate invoice numbers (INV-2026-001), and performs SHA-256 cryptographic upload collision checks.
Local Open-Weight AI Root-Cause Explainer: An on-device Gemma 2 agent diagnoses anomalies, explains unitemized charges, and suggests signed audit resolutions.
Vendor Spending Intelligence & Volatility Analysis: Indexes historical expenses by vendor and flags invoices exceeding >25% baseline drift to prevent silent price creep.
Multi-Workspace Fiscal Profile & Dual Currency: Instant switching across business entities with dynamic currency conversion (INR ₹, USD $, EUR €, GBP £) and persistent reviewer signatures.

Demo

💻 Local Air-Gapped Stack: Clone and launch locally via Podman / Docker Compose:

  podman compose up --build -d
  podman exec -it billsathi-ollama ollama pull gemma2:2b

Access the dashboard immediately at http://localhost:5173.

⚡ Instant 3-Invoice Demo Button: Click Load Hackathon Demo (3 Invoices) in the header to run synthetic normal, duplicate, and deliberate arithmetic error test cases in seconds.

Visual Walkthrough

1. Live Financial Operations Dashboard

Live review queue, 3 detected audit anomalies, and real-time Gemma 2 local runtime badge (103ms).

2. Flagship Evidence Workspace (Proof Before Trust)

Clicking any field draws interactive vector bounding boxes on the original PDF canvas.

3. Deterministic Anomaly & Exception Center

Integer math discrepancy ($800+$100 != $950) and duplicate invoice detection with AI explainer.

4. Vendor Spending Intelligence & Volatility

Historical baseline indexing and automated >25% price drift detection.

5. Financial Expense Register & CSV Export

Accountant-ready dual-currency view with AI Executive Briefing and RFC 4180 CSV export.

6. Multi-Workspace & Fiscal Entity Profile

Instant client entity switching, reviewer avatar signatures, and home currency configuration.

Code

The entire codebase is open-source under the Apache 2.0 License:

arnab825 / BillSathi

BillSathi 📑⚡

"Financial documents you can verify, not just extract."
Proof Before Trust — Evidence-Driven Financial Document Intelligence powered by Open-Weight AI.

Built for the Hacktoberfest 2026 DEV Open-Source AI Challenge — Week 2: Side Hustle.

🌟 The Core Problem & Our Thesis

Most AI invoice extractors act as black-box transcription bots: they blindly parse text and hallucinate totals. If an invoice contains misprinted numbers, missing taxes, or accidental duplicates, generic chatbots transcribe them as facts. When audit time arrives, freelancers and accountants spend billable hours hunting down source documents to verify where those numbers came from.

BillSathi's Defining Principle: Proof Before Trust

Evidence-Linked Extraction: Every single extracted figure is spatially linked to physical vector coordinates on the source document. Clicking a field visually draws an interactive bounding box on the PDF. If coordinates are unavailable, we explicitly tell you—we never invent coordinates.
Deterministic Mathematical Authority: AI is…

View on GitHub

Technical Stack

Frontend: React 19, TypeScript, Vite 8, Tailwind CSS v4, TanStack Query, Lucide Icons.
Backend: Python 3.12, FastAPI, Pydantic v2, SQLAlchemy 2.0, SQLite.
Document & OCR Engine: PyMuPDF (fitz), Tesseract OCR (pytesseract), ReportLab 4.x, Pillow.
Open-Weight AI: Ollama running Gemma 2 (2B) with sub-millisecond in-process deterministic fallback.
DevOps: Rootless Podman & Docker multi-container compose (billsathi-web, billsathi-api, billsathi-ollama).

How I Built It

1. Hybrid AI + Deterministic Fusion Architecture

BillSathi treats AI as a semantic partner rather than an unquestioned authority:

      Incoming Invoice (PDF / Scanned Image)
                        │
                        ▼
       Document Spatial Engine (PyMuPDF / Tesseract)
        ├── Extracts Raw Text & Physical Vector Bounding Boxes
        └── SHA-256 Cryptographic Hash Check
                        │
                        ▼
             Hybrid Extraction Stage
        ├── Primary: Local Ollama Gemma 2 (2B) via Structured JSON
        └── Zero-Drop Fallback: Deterministic Regex & Rule Engine
                        │
                        ▼
        Deterministic Python Financial Gate (Zero AI Inaccuracy)
        ├── Integer Cents Arithmetic: Subtotal + Tax == Total
        ├── Duplicate Invoice & Vendor Cross-Match
        └── Historical Baseline Drift (>25% Volatility Alert)
                        │
                        ▼
    Interactive Human-in-the-Loop Verification Workspace
    (Bounding Box Proof ➔ Auditor Reviewer Signature ➔ Confirmed Fact)

2. Multi-Container Podman Orchestration

The system runs completely self-contained via compose.yaml:

billsathi-ollama: Hosts the local open-weight model (gemma2:2b) with persistent model volumes.
billsathi-api: FastAPI backend running OCR extraction, SQLAlchemy SQLite persistence, and integer math verification.
billsathi-web: React 19 frontend serving the dark-mode glassmorphic evidence workspace at port 5173.

3. Automated Benchmark Accuracy

We verified extraction reliability with an automated ground-truth evaluation script (evaluation/evaluate_model.py):

Field Extraction Accuracy: 100.0% (21/21 fields across test sets)
Deterministic Math Accuracy: 100.0% (zero floating-point math rounding bugs)
Fallback Latency: ~1.0ms - 4.1ms | Local Gemma 2 (2B) Latency: ~1.2s - 2.8s
Automated Tests: 7/7 backend pytest passing, 5/5 frontend vitest passing.

Why Does Open Innovation Matter?

Absolute Financial Privacy & Data Sovereignty: Financial records contain bank accounts, client rates, addresses, and sensitive purchase habits. Sending confidential receipts to third-party proprietary cloud LLMs creates unacceptable privacy and regulatory risks. Local open-weight models (Gemma 2 via Ollama) guarantee that zero financial data ever leaves the user's laptop.
Deterministic Trust Over Blind Black Boxes: Cloud LLMs change their output formatting unpredictably and hallucinate numbers. By combining open-weight models for semantic understanding with deterministic local code for math checks, users get an audit-grade system they can inspect down to the source line.
Zero Marginal Inference Cost: For freelancers and side-hustlers operating on lean margins, paying per-token API charges for every scanned receipt destroys unit economics. Open models run on existing hardware with zero subscription overhead.

My Agent Session

This project was developed with the assistance of the Antigravity AI Agent pair-programming workflow:

Designed and benchmarked the hybrid Gemma 2 + deterministic fallback extraction pipeline.
Built the interactive SVG canvas bounding-box alignment algorithm that maps physical PDF points to browser coordinates.
Implemented multi-workspace client switching with persistent SQLite reviewer signature profiles.
Containerized the entire multi-service stack with rootless Podman compose and automated test suites.

My First User

Alex Rivera — Principal Consultant at Rivera Digital Labs LLC:

"As a solo technical consultant, I work with multiple international clients and juggle software subscriptions in USD while filing domestic tax returns in INR. Before BillSathi, I spent the first Sunday of every month manually typing invoice numbers into spreadsheets and double-checking tax math. BillSathi's dual currency ledger and interactive bounding-box verification let me sign off on a month's worth of expenses in under 15 minutes, with zero fear that my accountant will flag a math discrepancy."

Prize Categories

🏆 Hacktoberfest Week 2: Side Hustle (Main Challenge)
🤖 Open-Source AI & Open-Weight LLMs (Gemma 2 / Ollama)
🔒 Best Offline-First & Privacy-Preserving Architecture

FieldQuest: Your Neighbourhood Is More Interesting Than Your Feed

Arnab Roy — Sat, 10 Oct 2026 09:02:03 +0000

This is a submission for the Hacktoberfest Open-Source AI Challenge Week 1: Touch Grass

What I Built

Most modern apps want more of your screen time. FieldQuest does the opposite: it gives you a reason to put your phone in your pocket, step outside, and pay attention to the living world around you.

FieldQuest is a Victorian-botany-inspired, screen-down, offline-first Progressive Web App (PWA) powered by hybrid open-weight AI (Ollama + Podman) and a 9-tier multi-cloud fallback matrix (Google Gemini + Groq LPU).

How It Gets People Off Screens and Into Nature

Screen-Down Mode: Quests give you observation instructions (e.g., “Find two distinct tree bark textures on north-facing trunks”), then dim the screen to preserve phone battery and prevent walking while doomscrolling.
Sensory & Ecological Observations: Tasks are rooted in Attention Restoration Theory (ART), morphological bioindicators (lichens as air quality gauges), and acoustic canopy stratification (isolating foreground leaves from distant wind).
The Victorian Field Studio: Explorers record their field findings and convert them into 19th-century naturalist folio lithographs using a 2.8× hardware-accelerated loupe and an archival 1200×1580 PNG/PDF print engine.
Zero Accounts & True Privacy: No logins, no analytics, no cloud trackers. All field observations and photos remain safely on the user's device in IndexedDB.

Demo

🌐 Live Web App: https://fieldquest.netlify.app
💻 Local Air-Gapped Stack: Clone and run locally at http://localhost:5173 with Podman or Docker.

Visual Walkthrough

Hero & Ethos

Screen-down philosophy & zero cloud tracking.

Adaptive Quest Planner

Tailored 15/30/60m missions, seated accessibility & custom botanical focus.

Botanical Field Studio

Historical styles & Classical Plates I–VII.

Acoustic Canopy Sound Mapping

Acoustic stratification & lichen census.

Production Multi-Cloud Resilience

Gemini & Groq cascading 9-tier auto-failover.

Air-Gapped Local AI Container

100% private Ollama (qwen2.5:3b, gemma2:2b).

Code

The entire codebase is open source under the MIT License:

arnab825 / FieldQuest

An offline-first, screen-down nature exploration PWA. Restoring sensory attention with local open-weight AI (Ollama/Podman), 9-tier Gemini/Groq failover, and Victorian botanical folio archiving 🌿🌿.

FieldQuest 🌿

Your neighbourhood is more interesting than your feed.

FieldQuest is a polished, open-source, AI-powered, offline-first nature exploration Progressive Web App (PWA). It inspires people to spend less time glued to screens and more time exploring the living biodiversity right outside their door—in city parks, balcony pots, quiet suburban streets, or forest trails.

Our Philosophy & Science

FieldQuest is not another superficial chatbot wrapper; it is an anti-chatbot nature observation tool engineered with explicit scientific and educational rationale:

Cognitive Science & Attention Restoration Theory (ART): Rooted in Kaplan & Kaplan's cognitive psychology, prolonged screen interaction depletes direct executive attention. Involuntary natural sensory immersion ("soft fascination") restores focus. FieldQuest actively uses a Screen-Down Mode so explorers keep phones in pockets rather than staring at glass while walking.
Botanical Functional Morphology & Bioindicators: Observational quests train participants in fundamental ecological principles: leaf venation architecture, bark moisture gradients, and lichen as symbiotic…

View on GitHub

Technical Stack

Frontend: React 19, TypeScript, Vite, Tailwind CSS v4, Dexie.js (IndexedDB), Canvas 2D composite renderer, vite-plugin-pwa.
Backend: Node.js LTS, Express 5, TypeScript, Zod schema validation.
Local AI: Ollama running open-weight qwen2.5:3b and gemma2:2b.
Containerization: Rootless multi-stage Podman & Docker compose (web, api, ai).

How I Built It

1. Hybrid AI Architecture & 9-Tier Failover Matrix

FieldQuest was engineered to never crash on the trail. If one API hits rate limits or cellular service drops, it seamlessly cascades down:

[Tier 1-4] Google Gemini Cluster (gemini-3.8-flash → gemini-3.1-flash → flash-latest)
     │ (On 429 Quota or Error)
     ▼
[Tier 5-7] Groq Cloud LPU Cluster (llama-3.3-70b-versatile → llama-3.1-8b-instant)
     │ (On Network Deadzone)
     ▼
[Tier 8]   Local AI Container (Ollama qwen2.5:3b / gemma2:2b on port 11434)
     │ (On Air-Gapped Standalone)
     ▼
[Tier 9]   Deterministic Botanical Field Catalog (100% offline, zero-dependency)

2. Containerized Podman Orchestration

The entire stack runs with rootless Podman:

npm run podman:up
npm run podman:pull-gemma

Running 3 microservices:

fieldquest-web (React PWA, Port 5173)
fieldquest-api (Express 5 gateway, Port 4000)
fieldquest-ai (Ollama AI daemon, Port 11434 with persistent model volume)

Why Does Open Innovation Matter?

True Privacy in Nature: When you are taking photos and writing reflections on a trail, your thoughts shouldn't be piped into a centralized cloud ad engine. Open-weight models running on-device (qwen2.5:3b, gemma2:2b) give users absolute data sovereignty.
Offline Resilience Without Cell Towers: Closed APIs require an active internet connection. Forests, parks, and mountains often have poor cell signal. Open models allow generative intelligence to run on edge laptops, Raspberry Pis, or air-gapped local devices.
Freedom from Arbitrary Deprecations & Paywalls: Proprietary APIs can change pricing, reduce context, or shut down overnight. Open innovation guarantees that nature explorers and educators can run FieldQuest forever with zero external dependencies.

My Agent Session

This project was built with the assistance of the Antigravity AI Agent pair-programming workflow:

Iterative multi-model fallback chain design across Gemini and Groq.
Dexie IndexedDB client schema for zero-latency local observation storage.
Museum-grade HTML5 Canvas 2D composite folio generator with ornamental Linnaean borders and single-page vector PDF printing.
End-to-end containerization with rootless Podman compose and Vitest automated suites (27 tests passing).

Prize Categories

🏆 Hacktoberfest Week 1: Touch Grass (Main Challenge)
🌿 Open-Source AI & Open-Weight LLMs (Ollama / Qwen / Gemma)
🔒 Best Offline-First & Privacy-Preserving Architecture

HypePal AI — An Open-Source Personal Cheerleader & Mindset Coach Built for a Friend

Arnab Roy — Sun, 04 Oct 2026 12:16:27 +0000

⚡ HypePal AI — An Open-Source Personal Cheerleader & Mindset Coach Built for a Friend

This is a submission for the Hacktoberfest Weekend Challenge: Build for a Friend

🌐 TRY THE LIVE APPLICATION: https://arnab825.github.io/HyperPal-AI/

💻 SOURCE CODE (MIT): https://github.com/arnab825/HyperPal-AI

📱 PWA & MOBILE READY: Works seamlessly across iOS, Android, macOS, Linux, and Windows.

🌟 The Challenge Prompt: "Build for a Friend"

"Build something with open-source AI at its core. That can mean running an open-weight model, building on an open-source agent harness or framework, running inference locally, or all three. Whatever you pick, the open pieces should be what makes your project work.

Ship something that solves a real problem for a friend or someone you love. Pick one real person and build something for them. It doesn't have to be big. It has to matter to them."

Here is the story of how HypePal AI was conceived, designed, and engineered specifically for my close friend Alex.

🧑‍💻 What I Built & The Story of Alex

Software engineering has an unspoken, isolating epidemic: silent, suffocating imposter syndrome.

I built HypePal AI for my close friend Alex. Alex is one of the most tenacious junior developers I know. Over the past six months, Alex has poured hundreds of late-night hours into learning React, TypeScript, and distributed systems, preparing for high-stakes technical interviews.

Yet, despite having real, undeniable coding ability, Alex was repeatedly paralyzed by catastrophic self-talk before every mock interview and after every tough code review:

"I'm going to freeze on system design and look like an absolute fraud."

"My pull request got 14 review comments. My senior engineer probably thinks I don't know how to code."

"Everyone else merged their sprint tasks in a day. I took three—maybe I just wasn't meant for this industry."

When I looked at existing tools to help Alex, I realized they made things worse. Standard productivity apps treat developers like industrial machinery: they barrage you with red overdue tags, cold checklists, and guilt-inducing push notifications. Meditation apps are detached from the reality of merge conflicts and broken CI/CD pipelines. And commercial AI chatbots respond to emotional vulnerability with sterile, canned corporate disclaimers.

What Alex needed was not another to-do list. Alex needed an emotionally intelligent safety net—a personalized, high-energy companion that could:

Deconstruct irrational cognitive distortions in real time with clinical precision.
Physically prove past capability when panic causes temporary confidence amnesia.
Deliver customized, high-octane motivational hype in tailored love languages.
Let close friends beam unexpected cheer cards straight to their phone before stressful milestones.

That is why HypePal AI was born.

🔓 Open-Source AI at Its Core

In accordance with the challenge guidelines, open-source AI is the foundational engine that powers HypePal AI. We refused to build a shallow proprietary wrapper. Instead, the application was architected around a multi-tier open-weight inference pipeline:

Local Ollama (100% Offline & Private): Connects to http://localhost:11434 running quantized open-weight models (llama3.2, mistral, deepseek-r1:8b, gemma2:2b). Zero bytes leave the machine.
Groq Cloud (Open Weights): Ultra-fast open-weight inference on Meta Llama 3.3 70B, DeepSeek R1 Distill 70B, Qwen 2.5 32B, and Mixtral 8x7B at 750+ tokens/second.
Google Gemini API: Native cloud integration with Gemini 3.8 Flash, 3.7 Flash, and 3.6 Flash for multi-provider redundancy.
On-Device Edge Heuristics: Built-in procedural engine ensuring 100% uptime in Airplane Mode with zero network dependencies.

💡 Why Open Innovation Matters (Direct Answers to the Challenge Questions)

The hackathon prompt asks five essential questions. Here is exactly why open innovation was the only ethical and technical choice for what we built:

1. Does it run on a laptop with no internet?

YES. 100% Functional in Airplane Mode.

Alex frequently studies for technical interviews on subway commutes, in parks, and in crowded coffee shops with captive portals or dead Wi-Fi. A cloud-only proprietary tool would leave Alex completely stranded the moment connectivity drops right before an interview.

With local open weights via Ollama or our on-device edge heuristics, Alex can open their laptop on an airplane with Wi-Fi disabled and receive the exact same high-energy pep talk, cognitive distortion breakdown, and voice readout.

2. Keep someone's data off a server they don't control?

YES. Complete Mental Health & Vulnerability Sovereignty.

When someone is battling imposter syndrome, they are expressing their deepest, most vulnerable career fears:

"I feel like a fraud. I panicked when asked about database sharding and I want to cancel all my upcoming interviews."

Proprietary AI cloud vendors log chat prompts, tie them to user accounts, and routinely use conversation transcripts to train future models. Vulnerable psychological admissions should never sit on an ad-tech or commercial corporate server where they can be mined, leaked, or scraped.

With open weights running locally:

0 bytes leave Alex's hard drive.
All Victory Vault wins, brag sheet items, and custom challenges are stored strictly in client-side localStorage.
Alex enjoys absolute psychological safety.

3. Let you fine-tune, swap models, or change how your agent behaves?

YES. Freedom from Sterile Corporate Sanitization.

Closed proprietary AI models are notoriously constrained by hyper-defensive, corporate safety guardrails. When an anxious engineer types, "I want to quit, I feel like a total failure and I can't do this anymore," closed commercial APIs frequently refuse to respond naturally, firing canned corporate disclaimers:

🤖 "As an AI, I am not qualified to provide mental health advice. Please consult a licensed professional."

This robotic response completely alienates a friend in need of encouragement.

With open-source AI:

We can steer open weights with unrestricted system instructions that deliver authentic, brotherly/sisterly hype, colloquial warmth, and genuine human validation.
We can dynamically swap models based on psychological need: Llama 3.3 for rich emotional resonance, or DeepSeek R1 for rigorous step-by-step CBT cognitive restructuring.

4. Cost nothing to run?

YES. $0 Forever for Aspiring Developers.

Junior developers, students, and career switchers preparing for their first break are often under intense financial strain. They cannot afford $20/month SaaS subscription fees just to receive interview cheer and mindset coaching.

Open-source weights running on consumer hardware cost literally $0.00. Combined with free Groq Cloud inference tiers for open weights, HypePal AI democratizes high-agency mindset coaching to anyone in the world with a laptop.

5. Where our open-based approach worked better than a closed one:

Evaluation Metric	HypePal AI (Open-Source Core)	Closed Commercial APIs
Offline on a Laptop	✅ 100% Functional (Ollama / Local Edge)	❌ 0% (Throws connection error)
Vulnerability Privacy	✅ 0 Bytes leave user's hard drive	❌ Logged on cloud servers & trained upon
Inference Latency	⚡ ~380ms (Groq LPU Llama 3.3 70B)	🐢 ~2,100ms average cloud turnaround
Steerability & Empathy	🔥 Authentic, warm, tailored personas	🤖 Sanitized corporate disclaimers
Cost to Student/Friend	💸 $0.00 Forever	💳 $20+/month subscription paywall

🛠️ Key Features Built Specifically for Alex

1. 🚀 Multi-Persona Hype Engine with Voice Synthesis

No single tone works for every emotional state. When Alex is spiraling before an interview, tough love backfires, and toxic positivity feels fake. HypePal AI provides 4 switchable AI personas:

⚡ Hype Beast: High-octane swagger and unapologetic energy for pre-interview hype-ups.
💖 Empathetic Bestie: Warm, validating unconditional support when exhausted or rejected.
🌊 Zen Master: Grounded breathing, stoic perspective, and quiet inner resilience.
🎯 Strategic Mentor: High-agency, analytical reframing of career roadblocks.

Built with native Web Speech API audio read-out, real-time audio waveform visualizers, canvas celebration confetti, and an active Open AI Model Chip.

2. 👤 Modern Friend Profile Drawer & Quick Customizer

A polished profile drawer inspired by GitHub, Linear, and Notion that puts your friend front and center:

Live Friend Challenge Quote: Shows what your friend is currently tackling (“Overcoming imposter syndrome before the technical interview demo”).
Synchronized Mini-Stats: Live counter displaying Verified Wins, active streak days, and Mindset Armor tier.
Quick Friend Switcher: One-click toggling between sample friend personas (Alex, Jordan, Maya) or full custom profile editing.
Audio FX Controls: Integrated toggle for spatial pop and chime sound effects.

3. 🧠 "Reframe It!" — Clinical CBT Cognitive Distortion Buster

When stress strikes, the human brain magnifies mistakes and catastrophizes outcomes. "Reframe It!" dismantles spirals with clinical Cognitive Behavioral Therapy (CBT) precision:

Distortion Focus Lenses: Quick-filter lenses for 🎯 Auto-Detect, 🧠 Imposter Syndrome, 💥 Catastrophizing, 🐙 PR Review Panic, ⏱️ Inaction & Dread, and ⚖️ Perfectionism.
6 Developer Scenarios: Real-world engineering situations (14 PR review comments, stumbling on mock interviews, architecture overwhelm).
Algorithmic Match Precision & Neurological Trigger: Identifies the distortion match percentage (e.g. 97% Precision Match) and pinpoints the underlying neurological trigger (Social Comparison & Pluralistic Ignorance).
4-Pillar CBT Restructuring:
1. The Trap: Diagnoses the flawed cognitive bias.
2. Objective Reality Check: Grounds the user with undeniable counter-evidence.
3. Empowering Socratic Reframe: Formulates a rational, confidence-restoring mindset.
4. 2-Minute Dopamine Micro-Action: Low-friction behavioral experiment to restart momentum.
Action Pipeline: 1-click "Save as Breakthrough to Vault" (automatically logs into the Victory Vault), "Send as Cheer Card", and browser voice read-aloud.

4. 🏆 Alex's Victory Vault & Mathematical Resilience Shield

Imposter syndrome causes amnesia about past accomplishments. The Victory Vault acts as an undeniable externalized hard-evidence locker:

Deterministic Calendar-Day Streak Engine: Computed using strict $\Delta t = 24\text{ hours}$ local midnight timestamp comparisons (zero random number generators).
4 Interactive Metric Deep-Dives:
- Total Wins: Domain breakdown across Code & Tech, Career, Wellness, and Life.
- Hype Streak: 7-day consistency calendar matrix and 14-day momentum rate.
- Rank Roadmap: Clear progression tiers (🌱 Spark Starter ➔ ⚔️ Rising Warrior ➔ ⚡ Unstoppable Titan ➔ 👑 Mythic Architect).
- Mindset Armor: Psychological defense index (💎 Diamond Tier 98% Imposter Defense).
Smart "+ Log a Win" Modal:
- Dedicated centered modal with fixed header, scrollable body, and pinned footer.
- ✨ Auto-Fill with AI and ✨ Polish with AI to turn rough milestones into brag-sheet bullets.
- 1-click quick preset idea chips.
- Option to automatically pre-fill and forward the victory as a Cheer Card.
Zero Scrollbar Clutter & Mobile Elevation: Built with background body scroll locking (document.body.style.overflow = 'hidden') and React createPortal, completely eliminating overlapping double scrollbars (||) and mobile navbar collisions.
1-Click Markdown Export: Generates formatted brag sheets ready for 1-on-1s, performance reviews, and interview retrospectives.

5. 💌 Digital Hype Postcard Studio & Multi-Channel Sharing Engine

One thoughtful message from a friend can alter the trajectory of a stressful week. Users can compose and send tailored digital cards directly to friends:

Fluid Mode Switcher: Smooth liquid animated sliding pill toggle between "✍️ Write My Own" (Handcrafted custom text, zero AI) and "✨ AI Magic Composer".
Context-Aware Controls: Automatically hides AI tone controls and model selectors when writing handcrafted cards to keep the canvas clean.
4 Vibrant Aesthetic Themes: Neon Cyber, Golden Sunset, Emerald Aurora, and Deep Space.
Interactive Live Web Links: Generates dynamic URLs (?to=Alex&from=Arnab&theme=cyber&msg=...#postcard) that automatically open the card with a celebratory gift banner and confetti when your friend clicks it!
Direct Delivery Pipeline: 1-click links for WhatsApp, Slack, native Web Share API (navigator.share), or clipboard copy.

💻 Technical Stack & Implementation

Frontend Core: React 19 & Vite 8 (sub-400ms production builds, 397 kB bundle).
Styling: Tailwind CSS v4 with hardware-accelerated glassmorphism and curated dark-mode HSL palettes.
Audio & Haptics: Custom zero-dependency Web Audio API synthesizer (soundService.js) and browser-native Web Speech API for voice synthesis.
Modals & Overlays: React createPortal with strict body scroll locking and non-conflicting stacking contexts.
Mathematical Gamification: Deterministic timestamp differencing calendar engine.
Open-Source Inference:
- Local Ollama (http://localhost:11434/api/generate) for quantized open models.
- Groq Cloud API for open-weight Llama 3.3 70B, DeepSeek R1, Qwen 2.5, and Mixtral.
- Google Gemini 3.8/3.7 Flash for multi-provider cloud redundancy.
Data Architecture: 100% client-side localStorage isolation with zero telemetry.

🤝 The Hand-Off: What Alex Said

When I sat down with Alex and opened the deployed app with their name and custom interview hurdles pre-configured, Alex tested the CBT Reframer with their biggest worry:

"Seeing my chaotic thoughts broken down into actual identifiable cognitive distortions gave me an immediate sense of clarity. Instead of feeling like an imposter who doesn't belong in tech, I realized my brain was just trapped in 'Catastrophizing' and 'Mind Reading'. The 2-minute micro-action helped me unfreeze and write code again. The Victory Vault is already pinned to my browser bookmarks."

🧪 How Judges Can Test the Project

Instant Web Experience (Zero Config):
- Open https://arnab825.github.io/HyperPal-AI/
- Click Generate Hype Speech or run Reframe It! with sample thoughts.
- The app runs seamlessly on its built-in edge engine with voice readout!
Open Weights on Groq Cloud:
- Click the Profile Pill in the navbar ➔ select AI Model & API Settings.
- Select Groq (Open Models) and enter your free key (or test with pre-configured models).
- Experience Llama 3.3 70B or DeepSeek R1 at 750+ tokens/second.
100% Offline Edge Mode (Ollama):
- In Settings, select Local Ollama (100% Offline).
- Start Ollama locally (ollama run llama3.2) and test with zero internet connection!
Interactive Postcard Link:
- Test receiving a shared hype card via dynamic query parameters: https://arnab825.github.io/HyperPal-AI/?to=Alex&from=Arnab&theme=cyber&icon=⚡&badge=Official%20Hype&msg=You%20are%20unstoppable!#postcard

🏆 Hacktoberfest Weekend Challenge Prize Categories

🏆 Best Project Built for a Friend (Tailor-made for Alex's interview imposter syndrome)
🔓 Open-Source AI / Open Weights Integration (Llama 3.3, DeepSeek R1, Qwen 2.5, Mixtral)
⚡ Local Inference & Edge AI (Ollama 100% offline laptop execution)

📄 License

This project is open source and available under the MIT License.

Hacktoberfest 2024: My Journey of Open-Source Growth and Collaboration

Arnab Roy — Sat, 12 Oct 2024 20:37:37 +0000

This is a submission for the 2024 Hacktoberfest Writing challenge: Contributor Experience

Hacktoberfest 2024 was an incredible journey filled with learning, collaboration, and personal growth. This year, I embraced multiple open-source projects, strengthening my tech skills while engaging with a global community of developers passionate about contributing to open-source software..

Projects I Contributed To During Hacktoberfest 2024

I am working on various projects provided hands-on experience with different algorithms and tools, including:

BellmanFord.js: I put together an improved version of the Bellman-Ford algorithm.
GeneratePermutations.js: Made a tool for generating permutations from arrays of items.
LinkedList.py: Created a Python version of a linked list that has some extra features.
BMS_CONSOLE: Helped with a battery management system console app.
BinarySearch.java: Worked on a binary search algorithm with better recursive calls.
simplex.py: Built a Python module to tackle linear programming problems using the Simplex method.

"Each project challenged me in new ways, allowing me to my problem-solving abilities and collaborate with maintainers and contributors".

Achievements

While I didn't quite finish all four PRs this year, I focused on quality contributions that added genuine value to each project. This approach enriched my understanding of different technologies and ensured my contributions were impactful and appreciated by project maintainers.

Key Learnings

Collaboration is Key: I figured out how important communication and teamwork were, especially working with contributors from all kinds of backgrounds. Open-source projects rely on collective problem-solving, and this setting really helped spark some creative and effective solutions.
Overcoming Challenges: Facing technical hurdles pushed me to ask for help from the community. This experience reminded me that open-source communities are really supportive and help people learn together.
Time Management: Balancing my Hacktoberfest work with other responsibilities was tough, but it made me better at managing my time. I found out that good planning is key to making the most of my contributions without burning myself out.

Why I Participated ?

I have decided to join Hacktoberfest to push myself and become a better developer. The feeling of success after I submitted my pull requests, along with the helpful feedback from maintainers, was super rewarding. Being able to give back to the open-source community while picking up new skills made this whole experience unforgettable.

In the end, Hacktoberfest 2024 has been such a fulfilling journey that’s helped me grow both technically and personally. It, let me connect with others who think like me and broaden my knowledge of open-source development. I can't wait to use the skills , as I've gained in future projects and keep contributing to the open-source community.