search

Agent Kit Embedded search by Lamatic.ai

Agent Kit Embedded Search is an AI-powered document/website search system built with Lamatic.ai. It uses intelligent workflows to index PDFs and webpages, then provides an interactive search widget where users can search across their data in seconds.

---

Lamatic Setup (Pre and Post)

Before running this project, you must build and deploy the flow in Lamatic, then wire its config into this codebase.

Pre: Build in Lamatic

1. Sign in or sign up at https://lamatic.ai
2. Create a project (if you don’t have one yet)
3. Click “+ New Flow” and select "Templates"
4. Select the 'Embed Search' agent kit
5. Configure providers/tools/inputs as prompted
6. Deploy the kit in Lamatic and obtain your .env keys
7. Copy the keys from your studio

Post: Wire into this repo

1. Create a .env file and set the keys
2. Install and run locally:
   • npm install
   • npm run dev
3. Deploy (Vercel recommended):
   • Import your repo, set the project’s Root Directory (if applicable)
   • Add env vars in Vercel (same as your .env)
   • Deploy and test your live URL

Notes

• Coming soon: single-click export and “Connect Git” in Lamatic to push config directly to your repo.

---

🔑 Setup

Required Keys and Config

You’ll need two things to run this project locally:

1. .env Keys → get it from your Lamatic account post kit deployment.
2. Vercel Blob Token – Required for uploaded file storage. Each deployment needs its own Blob token. You can generate it from your Vercel project after the first deploy (see instructions below).

Item	Purpose	Where to Get It
.env Key	Authentication for Lamatic AI APIs and Orchestration	lamatic.ai
Blob Read/Write Token	Uploaded file storage	Vercel Blob Quickstart

1. Environment Variables

Create .env.local with:

# Lamatic
EMBEDDED_SEARCH_PDF_INDEXATION = "EMBEDDED_SEARCH_PDF_INDEXATION Flow ID"
EMBEDDED_SEARCH_WEBSITES_INDEXATION = "EMBEDDED_SEARCH_WEBSITES_INDEXATION Flow ID"
EMBEDDED_SEARCH_RESOURCE_DELETION = "EMBEDDED_SEARCH_RESOURCE_DELETION Flow ID"
EMBEDDED_SEARCH_SEARCH = "EMBEDDED_SEARCH_SEARCH Flow ID"
LAMATIC_API_URL = "LAMATIC_API_URL"
LAMATIC_PROJECT_ID = "LAMATIC_PROJECT_ID"
LAMATIC_API_KEY = "LAMATIC_API_KEY"

# Vercel Blob (configured on Vercel)
BLOB_READ_WRITE_TOKEN=your_blob_token

2. Install & Run

npm install
npm run dev
# Open http://localhost:3000

3. Deploy Instructions (Vercel)

Click the “Deploy with Vercel” button.

Fill in .env Keys from lamatic (required).

After deployment, generate your own Blob token:

vercel storage blob token create

Add/Replace it in Vercel Dashboard → Environment Variables → BLOB_READ_WRITE_TOKEN and redeploy.

📂 Repo Structure

/actions
 └── orchestrate.ts        # Lamatic workflow orchestration
/app
 ├── page.tsx              # Main upload/indexation UI
 ├── search
 │   └── page.tsx          # Search interface with documents
 └── api
     ├── index             # PDF indexation endpoint
     ├── index-webpages    # Webpage indexation endpoint
     ├── delete            # PDF deletion endpoint
     ├── delete-resource   # Resource deletion endpoint
     └── check-workflow-status  # Async workflow polling
/lib
 └── lamatic-client.ts     # Lamatic SDK client
/public
 └── images
     ├── lamatic-logo.png  # Lamatic branding
     └── *.png             # Data source icons
/flows
  └── ...                  # Lamatic Flows
/package.json              # Dependencies & scripts

---

🤝 Contributing

We welcome contributions! Open an issue or PR in this repo.

---

📜 License

MIT License – see LICENSE.