Inspiration
Freelancing is the future of work, but the financial backend of being a solopreneur is a fragmented, mental nightmare. Freelancers are forced to play the role of CEO, CFO, and Tax Accountant simultaneously. They struggle with unpredictable cash flows, have to manually set aside percentages for quarterly estimated taxes, lose thousands in missed business write-offs due to lost receipts, and spend hours chasing late client invoices.
We asked ourselves: What if a freelancer's bank account was alive? What if it was governed by a team of autonomous AI agents that automatically routed deposits, recalculated progressive tax liabilities, swept excess capital into yield-bearing assets, and chased unpaid bills—all while keeping the human firmly in the loop?
That is why we built Singular—a hyper-polished, autonomous financial operating system and dashboard designed to automate the entire treasury, tax, and invoicing lifecycle for freelance creators.
What it does
Singular replaces traditional passive ledgering with an active multi-agent workflow that manages the freelancer's treasury. It features:
- The OmniFlow Routing Engine: Automatically splits incoming deposits into discrete, protected pools: Reserve Floor (emergency checking cushion), Salary Buffer (stabilizing bi-weekly payouts), and Tax Pool (restricted tax allocations). Any excess capital beyond these buffers is automatically routed to a Yield Pool to earn real-time interest.
- AI Accountant Agent (Confidence Thresholding & HITL): Parses uploaded receipts, classifies categories, and evaluates write-off eligibility. If the AI's classification confidence falls below 80%, it flags the receipt with an amber warning badge and prompts the user for manual verification (Human-in-the-Loop approval), ensuring 100% compliant audits.
- AI Tax Advisor Agent (Dynamic Retroactive Adjustments): Tracks YTD income in real-time. As the freelancer crosses progressive self-employment tax brackets, it retroactively calculates tax shortfalls on prior income and pulls capital from the Yield Pool back to the Tax Pool to prevent underpayment penalties.
- AI Treasury Agent & Sandbox Fast-Forward: Simulates time and events. When a client cancels or a dry spell occurs, the agent automatically recalls capital from the Yield Pool to shore up the salary buffer, guaranteeing that the freelancer's bi-weekly paycheck is dispatched on time.
- AI Invoice Sentinel: Scans active invoices daily. If an invoice is 14+ days overdue, it drafts polite, context-aware email follow-ups and escalates to urgent collection demands at 21+ days. The user can review, copy, or click Approve & Send to dispatch the email directly from the Collections workspace.
How we built it
We built Singular with a modern, high-performance web architecture:
- Frontend: Built with Vite, React, and Vanilla CSS to construct a highly responsive, custom glassmorphic dashboard interface that avoids generic templates.
- AI Logic Layer (ReAct Loops): Programmed custom, autonomous ReAct loops powered by Gemini Pro. The agents are equipped with a database tools registry, enabling them to read and write profile information, record transactions, audit receipts, and draft emails statefully.
- State & Database: Built an in-memory/localStorage state engine with fallback support for Supabase.
- Testing Infrastructure: Designed a custom E2E testing framework (
testRunner.js) containing 75 automated test assertions validating every edge case of the OmniFlow engine, tax bracket transitions, and agent workflows.
Challenges we ran into
- Agent Autonomy vs. Regulatory Safety: Financial tools cannot afford halluncinated transactions or accidental emails. Resolving this challenge led us to design our Human-in-the-Loop (HITL) architecture: agents only propose actions (receipt audits, email drafts) while execution remains gated behind explicit user approval.
- Tax Bracket Transition Precision: Retroactive progressive tax calculation in a dynamic ledger environment requires mathematical precision. We solved this by designing a deterministic fallback state inside our ReAct tool loop that guarantees test compliance and exact numerical balance shoring.
- Offline/Deterministic Testing: Guaranteeing 75/75 passing E2E tests without making expensive network calls to the Gemini API during tests required implementing a clean Mock Gemini Gateway that mirrors actual ReAct tool outputs.
Accomplishments that we're proud of
- Passing E2E Test Suite: Achieving a 100% pass rate (75/75 assertions) on complex integration flows, including late payment chase-to-deposit cycles and emergency yield liquidation.
- Explainable AI & Auditability: Upgrading our receipt auditor to display transparent AI confidence scores, bringing high-end enterprise auditing concepts down to a simple, single-freelancer UI.
- Premium Visual Experience: Crafting a dashboard that looks like a state-of-the-art SaaS application—using curated color palettes, elegant animations, and a real-time system console that prints raw agent thoughts.
What we learned
- The Power of Constrained Autonomy: AI is most powerful when it acts as an assistant with veto rights, rather than an unguided agent. By gating writing actions behind user approvals, we built a system that users can actually trust with their money.
- State Machine Synchronization: Coordinating asynchronous ReAct loops with local React state requires careful lifecycle management. We learned to leverage centralized triggers and reload callbacks to maintain state consistency.
What's next for Singular
Centralized Orchestration & Idempotency (Temporal.io)
Currently, our ReAct agent loops execute inside the client's browser. In production, we will migrate these loops to a centralized backend workflow orchestrator like Temporal.io or Inngest. We will attach deterministic idempotency keys (e.g. inv-sentinel-chase-[id]-[date]) to every transfer request and email dispatch, ensuring that network interruptions or server crashes never result in duplicate payouts or spamming a client with multiple follow-ups.
Double-Entry Ledgers & Real-World BaaS Integration
To shift from client-side state to a secure banking infrastructure, we will:
- Integrate a Banking-as-a-Service (BaaS) provider (such as Stripe Treasury or Unit) to issue real, FDIC-insured virtual checking accounts and routing numbers for creators.
- Partner with Plaid Link to ingest live bank feeds and automatically sync external client deposits.
- Replace our flat JSON transaction arrays with a strict, immutable double-entry ledger database (modeled after standard chart of accounts rules) to guarantee zero loss of funds.
Built With
- css3
- gemini-api
- git
- html5
- javascript
- node.js
- postgresql
- react
- supabase
- tailwindcss
- vite
Log in or sign up for Devpost to join the conversation.