SpecOS

Role: Founder

Scope: Product Design & Branding, Full-Stack Development, Data Architecture & AI Integration

Timeline: January 2025 - December 2025

Tech Used

Frontend: SvelteKit, Tailwind CSS
Backend:Supabase, Vercel, Pinecone
Data Processing:Python

AI-powered product discovery for construction

SpecOS is a conversational and image-based product discovery platform built for construction. It takes product data from 328K+ products, 1.25M variants, and 9.2M product features and makes them searchable in seconds

What's the BTU rating of this?
Need a 3-ton AC unit for Florida
Looking for a 1/2 HP submersible sump pump
I need a 2-inch brass ball valve
20-amp GFCI outlet, outdoor rated
Need some LED shop lights, 4-foot
Im looking for a cordless impact driver kit
What pipe cutter for 1.5" copper?
R-30 insulation batts
Is installation hardware included?
SpecOS icon

Overview

Product data in construction is locked in catalogs and PDFs. Contractors waste hours chasing specs, while distributors lose sales when products can’t be found.

SpecOS transforms that workflow: ask in plain language or upload an image, and get structured results instantly.

Admin UI

Data intelligence dashboard for managing product enrichment, gap detection, and completeness scoring.

Scroll
SpecOS Screenshot 1
SpecOS Screenshot 2
SpecOS Screenshot 3
SpecOS Screenshot 4

Data Intelligence

Beyond search, SpecOS includes a data intelligence system that automatically improves product data quality.

Gap Detection

Automatically detects when customers ask questions that can't be answered due to missing product data, flagging gaps for enrichment.

Auto-Enrichment

Extracts missing values from product documentation using AI, automatically filling in spec sheets, PDFs, and technical data.

Completeness Scoring

Category-specific scoring ensures products aren't penalized for irrelevant attributes—only what matters for their category.

Custom AI Tools

The AI agent has access to 13 specialized tools that handle everything from natural language search to document retrieval.

searchProducts

Natural language product search

searchProductsByImage

Reverse image search using CLIP embeddings

findProductsByDescription

Semantic search across product catalog

getProductDetails

Retrieve full product specifications

lookupProductBySKU

Direct SKU lookup

findAlternatives

Find similar or substitute products

getProductAttachment

Fetch spec sheets and documentation

listProductAttachments

List all available product documents

searchProductDocumentation

Search within product PDFs

getProductAdvice

Multi-step product recommendation flow

getProductReviews

Retrieve product ratings and reviews

answerFromGlossary

Industry terminology definitions

answerGeneralQuestion

General construction knowledge

Agentic RAG Model

Our system uses an Agentic Retrieval Augmented Generation (RAG) model. This is a multi-step process that uses specialized AI "agents" to deliver more accurate and context-aware results than a standard chatbot.

Press enter or space to select a node. You can then use the arrow keys to move the node around. Press delete to remove it and escape to cancel.
Press enter or space to select an edge. You can then press delete to remove it or escape to cancel.

Agentic RAG Model Diagram

Press enter or space to select a node. You can then use the arrow keys to move the node around. Press delete to remove it and escape to cancel.
Press enter or space to select an edge. You can then press delete to remove it or escape to cancel.

Data Model

The data model is designed for flexibility to accommodate complex and varied product catalogs without requiring schema changes.

Core Schema

A brand has many products.
A product has many product_variations.

Flexible Attributes

EAV Model To handle a wide range of product specifications, we use an Entity-Attribute-Value (EAV) model.

Product-specific attributes (e.g., "Height", "Voltage", "Material") are stored in the product_features table as key-value pairs.

Press enter or space to select a node. You can then use the arrow keys to move the node around. Press delete to remove it and escape to cancel.
Press enter or space to select an edge. You can then press delete to remove it or escape to cancel.

getProductAdvice Sequence

This diagram is best viewed on desktop

Hardcoded Sequences

Critical multi-step interactions are not left to the discretion of the AI. They are explicitly coded as non-negotiable sequences to ensure reliability and safety.

Example

The getProductAdvice Sequence When a user asks for product advice, the system executes a mandatory 3-message sequence. This is a hardcoded rule, not an AI decision.

Press enter or space to select a node. You can then use the arrow keys to move the node around. Press delete to remove it and escape to cancel.
Press enter or space to select an edge. You can then press delete to remove it or escape to cancel.

Reverse Image Search Architecture

This diagram is best viewed on desktop

Model Agnostic

SpecOS was designed to be model agnostic allowing customers to choose their preferred model without having to change the code.

Powered by OpenAI
Powered by Google Gemini
Powered by Claude

Project Details

Role: Founder

  • Product Design & Branding
  • Full-Stack Development
  • Data Architecture & AI Integration

Tech Stack

Frontend: SvelteKit, Tailwind CSS
Backend: Supabase, Pinecone Vector DB
AI: Google Gemini, OpenAI CLIP
Data: 328K+ products, 9.2M+ product features
getspecos.com ↗
hero

© 2026 Ethan James Fox