🚀 Ovalpod (nDecide)

Ovalpod is a sophisticated, autonomous AI agent framework designed to turn complex business prompts into executable actions. By bridging the gap between LLMs and real-world business tools, Ovalpod enables end-to-end workflow automation—from analyzing emails and scraping competitor data to generating professional documents and managing CRM entries.

Built as a high-performance Electron desktop application, it combines the power of Next.js, LangGraph, and a suite of specialized automation tools to provide a seamless, agentic experience.

✨ Key Features

• 🤖 Autonomous Execution: Leverages LangGraph and multi-model AI (Gemini, OpenAI, Sarvam) to plan and execute multi-step workflows.
• 📧 Email Automation: Full-cycle email management including IMAP reading, Mailparser analysis, and Nodemailer delivery.
• 📄 Document Generation: Programmatic creation of professional PDFs, PowerPoint presentations, and Excel spreadsheets.
• 🌐 Web Automation: Integrated Playwright for high-fidelity web scraping and browser-based task execution.
• 🛠️ Ecosystem Integration: Native connectors for Notion, Supabase, Google Workspace, and various SQL databases (PostgreSQL, MySQL).
• 💳 Payment Integration: Integrated Razorpay for seamless subscription and billing management.
• 📈 Analytics: Deep behavioral insights powered by PostHog.

🛠️ Tech Stack

Core

• Frontend: Next.js 16 & React 19
• Desktop Shell: Electron
• Language: TypeScript
• Styling: Tailwind CSS 4
• Animations: Framer Motion

AI & Orchestration

• Orchestration: LangGraph & LangChain
• Models: Google Generative AI (Gemini), OpenAI, Sarvam AI
• Validation: Zod

Backend & Integration

• Database/Auth: Supabase
• External APIs: Google APIs, Notion API, Razorpay
• Data Processing: pdf-parse, mammoth, xlsx, pptxgenjs

🚀 Getting Started

Prerequisites

• Node.js: v20+ (Recommended)
• npm or pnpm

Installation

1. Clone the repository

   git clone https://github.com/your-username/ovalpod.git
   cd ovalpod

2. Install dependencies

   npm install

3. Environment Setup Create a .env.local file in the root directory and add your API keys:

   GOOGLE_API_KEY=your_google_key
   OPENAI_API_KEY=your_openai_key
   SUPABASE_URL=your_supabase_url
   SUPABASE_ANON_KEY=your_supabase_anon_key
   # Add other necessary keys for Notion, Razorpay, etc.

Running the App

Development Mode (Electron + Next.js)

npm run electron:dev

Build for Production

npm run electron:build

📂 Project Structure

├── electron/              # Electron main process and window management
├── src/                   # Next.js frontend and business logic
│   ├── components/        # Reusable UI components
│   ├── hooks/             # Custom React hooks
│   ├── lib/               # Utility functions and API clients
│   └── app/               # Next.js App Router pages
├── public/                # Static assets
├── next.config.ts         # Next.js configuration
└── package.json           # Project dependencies and scripts

🧪 Testing

The project uses Jest and React Testing Library for quality assurance.

npm test

📄 License

This project is licensed under the terms specified in the LICENSE file.