Skip to content

README.md

Latest commit

 

History

History
140 lines (105 loc) · 4.75 KB

README.md

File metadata and controls

140 lines (105 loc) · 4.75 KB

Agent Kit Sheets by Lamatic.ai

Demo

Live Demo

Agent Kit Sheets is an AI-powered spreadsheet application built with Lamatic.ai. It combines the familiar spreadsheet interface with intelligent AI workflows to transform, analyze, categorize, and summarize your data through a modern Next.js interface.

Deploy with Vercel

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 'Sheets' 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 one thing to run this project locally:

  1. .env Keys → get it from your Lamatic account post kit deployment.
Item Purpose Where to Get It
.env Key Authentication for Lamatic AI APIs and Orchestration lamatic.ai

1. Environment Variables

Create .env with:

# Lamatic
EMBEDDED_SHEETS = "EMBEDDED_SHEETS Flow ID"
LAMATIC_API_URL = "LAMATIC_API_URL"
LAMATIC_PROJECT_ID = "LAMATIC_PROJECT_ID"
LAMATIC_API_KEY = "LAMATIC_API_KEY"

# Spreadsheet Limits (defaults shown)
## Use 'inf' or '0' for unlimited in any of the above variables
NEXT_PUBLIC_MAX_ROWS=5
NEXT_PUBLIC_MAX_COLS=3
NEXT_PUBLIC_MAX_SHEETS=1
NEXT_PUBLIC_POLLING_INTERVAL=10

2. Install & Run

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

⌨️ Keyboard Shortcuts

Shortcut Action
Cmd/Ctrl + Shift + R Add new row
Cmd/Ctrl + Shift + C Add new column
Cmd/Ctrl + Shift + N Create new sheet

📂 Repo Structure

/actions
 └── orchestrate.ts        # Lamatic workflow orchestration
/app
 ├── page.tsx              # Main spreadsheet interface
 └── api
     └── webhook
         └── ai-result     # Webhook for AI processing results
/components
 ├── spreadsheet-grid.tsx  # Main grid component with resizable columns
 ├── editable-cell.tsx     # Cell editing logic
 ├── markdown-cell.tsx     # Markdown rendering in cells
 ├── add-column-panel.tsx  # Column creation popover
 ├── add-column-dialog.tsx # AI column configuration dialog
 ├── edit-column-dialog.tsx # Column editing dialog
 ├── csv-upload-dialog.tsx # CSV import interface
 ├── sheet-tabs.tsx        # Sheet navigation tabs
 ├── workbook-header.tsx   # Application header
 └── ui/                   # shadcn/ui components
/lib
 ├── store.ts              # Zustand state management
 ├── types.ts              # TypeScript type definitions
 ├── lamatic-client.ts     # Lamatic SDK client
 └── utils.ts              # Utility functions
/flows
  └── ...                  # Lamatic Flows
/package.json              # Dependencies & scripts

🤝 Contributing

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

📜 License

MIT License – see LICENSE.