AgentBook

AgentBook is a revolutionary AI-powered booking platform designed to streamline appointment management for small businesses. With a modern React interface and intelligent Gemini integration, it allows business owners to create profiles via chat and lets customers book appointments through a context-aware AI receptionist.

---

🧭 Table of Contents

• ✨ Features
• 🖥️ Overview
• 🛠️ Tech Stack
• 📂 Folder Structure
• 🚀 How to Run Locally
• 📸 Screenshots
• 🧩 Future Enhancements
• 🎯 Learning Outcomes
• 🤝 Contributing
• 🧾 License
• 👩‍💻 Author
• 💬 Quote

---

✨ Features

• 🤖 Conversational Onboarding – Business owners build their entire profile (Hours, Services, Pricing) simply by chatting with an AI.
• 🧠 Intelligent Data Extraction – The system automatically extracts structured data from unstructured chat conversations.
• 📅 AI Receptionist – Customers chat with a business-specific AI to check availability and book slots naturally.
• 🚀 Simulated Deployment – Experience a visual DevOps-style deployment process (DNS, SSL provisioning simulation).
• 📊 Smart Dashboard – View upcoming appointments and manage business details in real-time.
• ⚡ Instant Response – Powered by Gemini 1.5 Flash for low-latency interactions.
• 🎨 Responsive UI – Built with Tailwind CSS for a seamless experience on any device.

---

🖥️ Overview

AgentBook focuses on the intersection of Modern Web Development and Generative AI. It is an ideal project to understand how to build LLM-powered applications where the AI controls application state, not just text generation.

The app emphasizes:

• Prompt Engineering to force structured JSON outputs from AI.
• React State Management to handle real-time AI streaming.
• User Experience that replaces boring forms with natural conversation.

---

🛠️ Tech Stack

| Category | Technology Used | | --- | --- | | Frontend | React 19, Vite | | Language | TypeScript | | AI Model | Google Gemini 1.5 Flash (@google/genai) | | Styling | Tailwind CSS | | State/Storage | LocalStorage (Mock Database Service) | | Version Control | Git, GitHub |

---

📂 Folder Structure

AgentBook/
│
├── src/
│   ├── components/      # UI Components (ChatInterface, Dashboard)
│   ├── services/        # Logic Layer
│   │   ├── databaseService.ts  # Mock DB wrapper
│   │   ├── geminiService.ts    # AI API calls & System Prompts
│   │   └── deploymentService.ts # Deployment simulation
│   ├── App.tsx          # Main Routing & State Logic
│   └── types.ts         # TypeScript Interfaces
├── index.html           # Entry point
├── vite.config.ts       # Vite & Environment config
├── LICENSE              # MIT License
└── README.md            # Documentation

---

🚀 How to Run Locally

Follow these simple steps to set up and view the project on your local machine 👇

1️⃣ Clone the Repository

git clone https://github.com/vallabhatech/AgentBook.git

2️⃣ Navigate into the Project Folder

cd AgentBook

3️⃣ Install Dependencies

npm install

4️⃣ Environment Setup

Create a .env.local file in the root directory and add your Google Gemini API key:

GEMINI_API_KEY=your_actual_api_key_here

(Get a key from Google AI Studio)

5️⃣ Run the App

Start the development server:

npm run dev

Open the link shown (usually http://localhost:5173) in your browser.

---

📸 Screenshots

🏠 App Preview

Smart Booking Management – Replacing forms with intelligent conversations.

<img width="1923" height="1025" alt="image" src="https://github.com/user-attachments/assets/4cb73d4f-3baa-4c0f-bb1f-0138510bc43a" />

---

🧩 Future Enhancements

• 🔗 Real Backend – Migrate from LocalStorage to Firebase or Supabase.
• 📅 Calendar Sync – Integrate with Google Calendar or Outlook.
• 💳 Payments – Add Stripe integration for booking deposits.
• 🗣️ Voice Mode – Allow users to speak to the AI receptionist.
• 🔐 Auth System – Add real user authentication (Clerk or Auth0).

---

🎯 Learning Outcomes

By exploring this project, you’ll learn:

• 🧠 Prompt Engineering: How to write system prompts that control AI behavior.
• 🔍 Structured Generation: Extracting JSON data from LLM responses to update app state.
• ⚛️ Modern React: Using Hooks and TypeScript for robust frontend logic.
• 🛠️ Service Architecture: Separating AI logic, database logic, and UI components.

---

🤝 Contributing

Contributions are always welcome! If you’d like to improve AgentBook, follow these steps 👇

1. Fork the repository
2. Create a new branch

git checkout -b feature-name

3. Commit your changes

git commit -m "Added a new feature"

4. Push to your branch

git push origin feature-name

5. Open a Pull Request

---

🧾 License

This project is licensed under the MIT License – see the LICENSE file for details.

---

👩‍💻 Author

Vallabha Tech 🎓 AI Engineer | 💻 Full Stack Developer | 🌍 Open Source Enthusiast

📫 Connect with me:

• GitHub: @vallabhatech

---

💬 Quote

"The future of software isn't just about clicking buttons; it's about having a conversation. AgentBook brings that future to small businesses today."

---

🌟 Show Some Love

If you found this project useful or interesting, don’t forget to ⭐ Star the repository! Let’s build smarter AI agents together 💜