feat: Add research-paper-analyzer kit

kits/research-paper-analyzer/.env.example

@@ -0,0 +1,4 @@
+RESEARCH_PAPER_ANALYZER_FLOW_ID="your-flow-id"
+LAMATIC_API_URL="https://your-project.lamatic.ai"
+LAMATIC_PROJECT_ID="your-project-id"
+LAMATIC_API_KEY="your-api-key"

kits/research-paper-analyzer/.gitignore

@@ -0,0 +1,5 @@
+.env
+.env.local
+apps/node_modules
+apps/.next
+apps/.vercel

kits/research-paper-analyzer/README.md

@@ -0,0 +1,127 @@
+# Research Paper Analyzer
+
+An AI-powered kit that takes any academic PDF URL and returns a structured breakdown:
+
+- **Problem Statement** — what the research is trying to solve and why it matters
+- **Methodology** — how the study was conducted
+- **Key Findings** — the main results and conclusions
+- **Limitations** — acknowledged weaknesses or gaps
+- **Plain English Summary** — jargon-free explanation for non-specialists
+- **Follow-up Questions** — ideas for future research directions
+
+Built on [Lamatic.ai](https://lamatic.ai) with a **FastAPI** backend and a **React + Vite** frontend (JavaScript/JSX).
+
+---
+
+## Architecture
+
+```
+React (Vite/JSX)  →  FastAPI (Python)  →  Lamatic Flow  →  LLM
+   frontend              backend            orchestration
+ localhost:5173       localhost:8000
+```
+
+---
+
+## Quick Start
+
+### 1. Deploy the Flow in Lamatic Studio
+
+1. Go to [studio.lamatic.ai](https://studio.lamatic.ai) → New Project → New Flow
+2. Add nodes in this order:
+   - **API Trigger** — input schema: `{ pdf_url: string }`
+   - **Extract From File** — file URL: `{{trigger.pdf_url}}`
+   - **LLM Node** — use prompt from `prompts/analyze-paper.md`, structured JSON output
+   - **API Response** — output: `{{LLMNode.output}}`
+3. Deploy the flow and copy the **Flow ID** from Settings
+
+### 2. Start the FastAPI Backend
+
+```bash
+cd apps/backend
+cp .env.example .env
+# Fill in your Flow ID and Lamatic credentials in .env
+pip install -r requirements.txt
+uvicorn main:app --reload
+```
+
+Backend runs at [http://localhost:8000](http://localhost:8000).  
+Check [http://localhost:8000/docs](http://localhost:8000/docs) for the auto-generated API docs.
+
+`.env` values to fill in:
+```
+RESEARCH_PAPER_ANALYZER_FLOW_ID=<your-flow-id>
+LAMATIC_API_URL=<from Lamatic Settings>
+LAMATIC_PROJECT_ID=<from Lamatic Settings>
+LAMATIC_API_KEY=<from Lamatic Settings>
+```
+
+### 3. Start the React Frontend
+
+```bash
+cd apps/frontend
+npm install
+npm run dev
+```
+
+Frontend runs at [http://localhost:5173](http://localhost:5173).  
+Vite proxies `/analyze` → FastAPI automatically, so no CORS issues in dev.
+
+---
+
+## Usage
+
+1. Paste any publicly accessible PDF URL (e.g., an arXiv paper)
+2. Click **Analyze Paper**
+3. Browse the structured breakdown — expand/collapse each section
+4. Click **JSON** to copy the raw JSON output
+
+### Example URLs to try
+
+- `https://arxiv.org/pdf/2303.08774.pdf` — GPT-4 Technical Report
+- `https://arxiv.org/pdf/1706.03762.pdf` — Attention Is All You Need
+
+---
+
+## API Reference
+
+### `POST /analyze`
+
+**Request:**
+```json
+{ "pdf_url": "https://arxiv.org/pdf/2303.08774.pdf" }
+```
+
+**Response:**
+```json
+{
+  "success": true,
+  "data": {
+    "title": "...",
+    "authors": ["..."],
+    "year": 2023,
+    "problem_statement": "...",
+    "methodology": "...",
+    "key_findings": ["..."],
+    "limitations": ["..."],
+    "plain_english_summary": "...",
+    "follow_up_questions": ["..."]
+  }
+}
+```
+
+---
+
+## Tech Stack
+
+- **Backend**: FastAPI, Python, httpx, Pydantic, python-dotenv
+- **Frontend**: React.js, Vite, JavaScript/JSX, Tailwind CSS, Lucide React
+- **AI Orchestration**: Lamatic.ai flows
+
+---
+
+## Requirements
+
+- Python 3.10+
+- Node.js 18+, npm 9+
+- Lamatic.ai account ([sign up free](https://lamatic.ai))

kits/research-paper-analyzer/agent.md

@@ -0,0 +1,44 @@
+# Research Paper Analyzer Agent
+
+## Identity
+
+You are an expert academic research analyst. Your role is to read scientific papers and produce clear, structured analyses that help researchers, students, and professionals quickly understand complex academic work.
+
+## Capabilities
+
+- Extract and articulate the core research problem and motivation
+- Identify and explain the methodology used
+- Summarize key findings and results objectively
+- Surface limitations and potential gaps in the research
+- Translate academic language into plain English for non-specialists
+- Generate thoughtful follow-up research questions
+
+## Behavior Guidelines
+
+- Always base your analysis strictly on the paper content — do not hallucinate facts
+- Be objective; do not editorialize beyond what the paper states
+- If a section of the paper is unclear or missing, state that explicitly
+- Keep the plain-English summary accessible to a smart non-expert
+- Format all output as structured JSON matching the defined schema
+
+## Output Schema
+
+```json
+{
+  "title": "string",
+  "authors": ["string"],
+  "year": "number | null",
+  "problem_statement": "string",
+  "methodology": "string",
+  "key_findings": ["string"],
+  "limitations": ["string"],
+  "plain_english_summary": "string",
+  "follow_up_questions": ["string"]
+}
+```
+
+## Constraints
+
+- Never invent citations, statistics, or claims not present in the paper
+- Refuse requests to misrepresent or plagiarize research
+- If the uploaded file is not an academic paper, respond with a clear error message

kits/research-paper-analyzer/apps/.env.example

@@ -0,0 +1,4 @@
+RESEARCH_PAPER_ANALYZER_FLOW_ID="your-flow-id"
+LAMATIC_API_URL="https://your-project.lamatic.ai"
+LAMATIC_PROJECT_ID="your-project-id"
+LAMATIC_API_KEY="your-api-key"

kits/research-paper-analyzer/apps/actions/analyze.ts

@@ -0,0 +1,35 @@
+"use server";
+
+import { lamaticClient } from "@/lib/lamatic-client";
+
+export interface PaperAnalysis {
+  title: string;
+  authors: string[];
+  year: number;
+  problem_statement: string;
+  methodology: string;
+  key_findings: string[];
+  limitations: string[];
+  plain_english_summary: string;
+  follow_up_questions: string[];
+}
+
+export async function analyzePaper(
+  pdfUrl: string
+): Promise<{ success: boolean; data?: PaperAnalysis; error?: string }> {
+  try {
+    const flowId = process.env.RESEARCH_PAPER_ANALYZER_FLOW_ID;
+    if (!flowId) throw new Error("RESEARCH_PAPER_ANALYZER_FLOW_ID is not set.");
+
+    const resData = await lamaticClient.executeFlow(flowId, { pdf_url: pdfUrl });
+    const result = resData?.result ?? resData?.output ?? resData;
+
+    if (!result) throw new Error("No result returned from the flow.");
+
+    return { success: true, data: result as PaperAnalysis };
+  } catch (error) {
+    const message =
+      error instanceof Error ? error.message : "Unknown error occurred.";
+    return { success: false, error: message };
+  }
+}

kits/research-paper-analyzer/apps/app/globals.css

@@ -0,0 +1 @@
+@import 'tailwindcss';

kits/research-paper-analyzer/apps/app/layout.tsx

@@ -0,0 +1,22 @@
+import type { Metadata } from "next";
+import { Analytics } from "@vercel/analytics/next";
+import "./globals.css";
+
+export const metadata: Metadata = {
+  title: "Research Paper Analyzer",
+  description:
+    "Upload any academic PDF and get a structured breakdown: problem statement, methodology, key findings, limitations, plain-English summary, and follow-up research questions.",
+};
+
+export default function RootLayout({
+  children,
+}: Readonly<{ children: React.ReactNode }>) {
+  return (
+    <html lang="en">
+      <body className="antialiased">
+        {children}
+        <Analytics />
+      </body>
+    </html>
+  );
+}

kits/research-paper-analyzer/apps/app/page.tsx

@@ -0,0 +1,5 @@
+import { Analyzer } from "@/components/analyzer";
+
+export default function Home() {
+  return <Analyzer />;
+}