Clario

Decision intelligence that helps small business owners understand business health, test critical decisions, and turn insights into clear action.

Comment

Inspiration

Small business owners often have sales reports, customer balances, supplier obligations, inventory records, and cash figures—but still struggle to answer one urgent question:

What matters first, and what should I do next?

A business can look profitable on paper while still facing serious cash pressure. Clario was created to help owners see the real condition of the business before making decisions that may be difficult to reverse.

What it does

Clario is a business decision intelligence app for small business owners.

It guides the owner through one connected workflow:

Business data → Business Health → Ask Clario → Decision Lab → Decision-to-Action → Trust & Data

Business Health brings together the most important signals and shows where immediate attention is needed.

Ask Clario lets the owner ask real business questions using English, Filipino, or Taglish. GPT-5.6 examines the verified business context, explains risks, challenges assumptions, and recommends practical next steps.

Decision Lab allows the owner to test different payment, collection, and purchasing scenarios before making a commitment.

Trust & Data shows the records, calculations, assumptions, and certainty labels used in the analysis.

Decision-to-Action converts the chosen decision into clear tasks and professional customer, supplier, or staff communication drafts.

Demo scenario

The demonstration uses a fictional company called Aurora Essentials Trading.

Aurora has PHP 245,000 available today, while PHP 480,000 in payments are due within fourteen days.

The owner is considering a PHP 210,000 inventory purchase connected to a confirmed PHP 320,000 Pinebridge customer order. However, no Pinebridge payment has been received.

Clario explains why the purchase is unsafe under the current setup. It then evaluates what changes if Pinebridge pays the full order in advance.

The payment would make the purchase much safer, but Aurora may still face a small remaining cash gap with almost no safety buffer.

Clario therefore recommends approving the purchase only after the payment is actually received and recorded—not merely promised.

How we built it

Clario was built using Next.js, React, TypeScript, the OpenAI Responses API, GPT-5.6, and deterministic TypeScript calculation guards.

GPT-5.6 powers interpretation, prioritization, explanation, follow-up reasoning, multilingual conversation, and communication drafting.

Critical financial arithmetic is validated separately using canonical business records and deterministic calculation rules. If a generated figure conflicts with the verified ledger, Clario requests a corrected answer or refuses to display an unverified number.

The OpenAI API key remains server-side through an internal Next.js API route.

Codex supported development by inspecting the codebase, improving the user experience, diagnosing deployment failures, identifying missing repository files, and validating the final production build.

Challenges we faced

One major challenge was keeping the AI helpful without allowing it to become the source of truth for critical calculations.

We addressed this through a hybrid architecture: GPT-5.6 handles reasoning and communication, while deterministic validation protects important financial results.

We also faced Vercel deployment failures because the GitHub repository was missing important source directories. Codex helped inspect the exact project state, identify the incomplete repository snapshot, and validate the restored production application.

Another challenge was keeping the experience useful without overwhelming small business owners. We simplified the interface around one clear decision workflow and focused each response on the next practical step.

Accomplishments

  • Built a working business decision intelligence workflow rather than a generic chatbot
  • Integrated GPT-5.6 into the core live decision conversation
  • Added deterministic financial validation and unsafe-number rejection
  • Supported multi-turn conversations in English, Filipino, and Taglish
  • Created scenario testing, calculation transparency, and action-ready delegation
  • Successfully deployed the complete application to Vercel
  • Completed production build, TypeScript, and ESLint validation

What we learned

AI becomes more useful for business decisions when it is grounded in structured records, clearly separates facts from assumptions, and explains how a recommendation was reached.

We also learned that trust does not come from sounding certain. It comes from showing the numbers, validating the calculation, and refusing false certainty when information cannot be verified.

What is next

Future versions of Clario may include secure accounting and commerce connections, automated reconciliation, multi-company workspaces, role-based permissions, owner approval workflows, recurring risk monitoring, and historical decision tracking.

The long-term vision is to help small business owners move from scattered records to clearer, more responsible decisions.

Clario — Your Business Clarity Partner.

Built With

Share this project:

Updates