HeHo 🚀

The Ultimate AI-Powered Backend & Database Orchestrator

HeHo is a powerful, context-aware platform designed to bridge the gap between AI, APIs, and your data. It allows you to build sophisticated AI-driven backends that connect directly to your own Supabase database, enabling autonomous data management, custom API generation, and intelligent chatbot integration without writing a single line of code.

---

✨ Key Features

🛠️ AI-Powered Backend Provider

• Autonomous DB Management: Connect your Supabase database and let AI read, write, and create tables based on high-level business logic.
• Custom API Generation: Automatically generate and deploy RESTful API endpoints that interact with your data and AI models.
• Project Context Awareness: Upload detailed project descriptions so the entire backend understands your full business context and logic.

🤖 Advanced Chatbot Integration

• Context-Aware AI: Powered by OpenRouter, giving you access to 35+ top-tier AI models (Llama, Mistral, GPT, etc.).
• Grounded Responses: Drastically reduce AI hallucinations by grounding the AI's knowledge in your actual database records and backend logic.
• No-Code Interface: Create and deploy intelligent agents in minutes via a user-friendly dashboard.

🔐 Security & Control

• Fine-Grained Permissions: You decide exactly which tables your AI can access and whether it can perform read, add, edit, or delete operations.
• Data Sovereignty: Your data never leaves your Supabase project. HeHo only acts as the intelligent orchestration layer.
• Encrypted Keys: All API keys are encrypted at rest using industry-standard AES-256 encryption.

---

🛠️ Tech Stack

HeHo is built with a modern, high-performance stack:

• Framework: Next.js 14 (App Router)
• Language: TypeScript
• Styling: Tailwind CSS with Shadcn UI
• Animations: Framer Motion & GSAP
• Database & Auth: Supabase
• AI Orchestration: OpenRouter API
• 3D Elements: Three.js (via React Three Fiber)

---

🔌 HeHo API (v1)

HeHo provides a robust REST API for developers to integrate AI backend services and database management into their own applications.

Authentication

All API requests require a Bearer token in the Authorization header:

Authorization: Bearer YOUR_HEHO_API_KEY

Endpoints

1. AI & Chat Services

• POST /api/aichat: Send a message to an AI agent and receive an intelligent, data-grounded reply.
• POST /api/verify-user: Verifies your API key and returns the complete user profile.

2. Chatbot Management API

• GET /api/v1/chatbots/manage: Retrieve a list of all your chatbots.
• POST /api/v1/chatbots/manage: Create and deploy a new AI-driven chatbot with specific configuration and data sources.
• DELETE /api/v1/chatbots/manage: Remove an existing chatbot configuration.

3. Database Management API

HeHo provides a powerful API for autonomous database management, allowing AI agents to interact directly with your Supabase data.

• GET /api/v1/database/manage: Fetch all connected tables and their detailed column structures.

  • Example Response:

    {
      "tables": [
        {
          "table_name": "products",
          "columns": [
            { "column_name": "id", "data_type": "uuid", "required": true },
            { "column_name": "name", "data_type": "text", "required": true },
            { "column_name": "price", "data_type": "numeric", "required": false }
          ]
        }
      ]
    }

• POST /api/v1/database/tables: Create a new table in your Supabase database.

  • Payload: { "tableName": "customers", "columns": [{ "name": "id", "type": "uuid", "primaryKey": true }, { "name": "name", "type": "text", "notNull": true }] }

• POST /api/v1/database/tables/connect: Connect an existing table from your Supabase database to HeHo.

  • Payload: { "tableName": "existing_table" }

• DELETE /api/v1/database/tables: Disconnect a table from your HeHo app. (Does NOT delete the table from Supabase).

  • Payload: { "tableName": "customers" }

• POST /api/v1/database/manage: Perform CRUD operations (Read, Add, Edit, Delete) on your connected tables.

  • Payload:

    {
      "action": "add",
      "tableName": "products",
      "data": { "name": "New Product", "price": 99.99 }
    }

    {
      "action": "read",
      "tableName": "products",
      "query": { "id": 1 }
    }

---

🚀 Getting Started

1. Connect Your Data

Sign up at the dashboard and connect your Supabase project via OAuth. HeHo will handle the initial handshake and permission setup.

2. Configure AI & Logic

Add your OpenRouter API key and upload your project documentation to define the "brain" of your backend.

3. Deploy & Integrate

Use the generated API endpoints or the built-in chatbot interface to power your applications with autonomous AI capabilities.

---

📜 License

HeHo is 100% open-source and licensed under the MIT License.

---

No code. No lock-in. Your data, your AI, your Backend.