https://github.com/composiohq/google-super-agent
https://github.com/composiohq/google-super-agent
Last synced: 2 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/composiohq/google-super-agent
- Owner: ComposioHQ
- Created: 2025-07-12T05:44:12.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2025-07-15T10:50:35.000Z (3 months ago)
- Last Synced: 2025-07-15T19:20:30.737Z (3 months ago)
- Language: TypeScript
- Homepage: https://google-super-agent.vercel.app
- Size: 263 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Super Agent
A powerful AI assistant powered by Google's Gemini AI that can generate content, create presentations, analyze Google Sheets/Docs, and provide intelligent responses. This application combines chat-based AI interaction with document integration and presentation generation capabilities.
## Features
- 🤖 **AI-Powered Assistant**: Chat with Super Agent for various tasks and content generation
- 📊 **Google Sheets Integration**: Connect and analyze Google Sheets directly in the interface
- 📄 **Google Docs Integration**: Connect and work with Google Docs seamlessly
- 🎨 **Presentation Creator**: Generate professional PowerPoint presentations with AI
- 📱 **Responsive Interface**: Works on desktop and mobile devices
- 🔄 **Real-time Chat**: Interactive chat interface with message history
- 📥 **Easy Download**: Export presentations as native PowerPoint (.pptx) files
- âš¡ **Smart URL Detection**: Automatically detects and connects Google Sheets/Docs URLs
- 🎯 **Multiple Tools**: General assistant, presentation creator, web search, image generation, and more
## Getting Started
### Prerequisites
- Node.js 18+ installed on your machine
- A Google AI Studio API key (free)
### Installation
1. **Clone the repository:**
```bash
git clone
cd genspark
```
2. **Install dependencies:**
```bash
npm install --legacy-peer-deps
```
3. **Set up environment variables:**
```bash
cp .env.example .env.local
```
4. **Get your Gemini API key:**
- Go to [Google AI Studio](https://aistudio.google.com/app/apikey)
- Create a new API key
- Copy the key and paste it in your `.env.local` file:
```
GOOGLE_GENERATIVE_AI_API_KEY=your_actual_api_key_here
```
5. **Run the development server:**
```bash
npm run dev
```
6. **Open your browser:**
Visit [http://localhost:3000](http://localhost:3000) to see the application.
## How to Use
### Chat with Super Agent
1. **Start a conversation** - Type any question or request in the chat interface
2. **Use example prompts** - Click on suggested prompts to get started quickly
3. **Get intelligent responses** - The AI will analyze your request and provide helpful responses
### Connect Google Sheets/Docs
1. **Paste a URL** - Simply paste a Google Sheets or Google Docs URL in the chat
2. **Automatic detection** - The app will automatically detect the URL and open a sidebar
3. **Interactive sidebar** - View and interact with your documents directly in the interface
4. **Ask questions** - Ask the AI about your spreadsheet data or document content
### Create Presentations
1. **Request a presentation** - Ask the AI to create slides about any topic
2. **Automatic generation** - The AI will generate structured slide content
3. **Preview slides** - Browse through the generated slides in the chat interface
4. **Download as PPT** - Click "Download PPT" to get your .pptx file
### Available Tools
- **General Assistant**: General AI conversation and help
- **Presentation Creator**: Generate slides and presentations
- **Web Search**: Search the web for information
- **Image Generator**: Create images with AI
- **Video Creator**: Generate video content
- **Phone Calls**: Make phone calls (integration)
- **File Manager**: Manage and work with files
## Opening Presentations
The downloaded .pptx file can be opened directly in:
- Microsoft PowerPoint
- Google Slides (File → Import slides)
- LibreOffice Impress
- Apple Keynote
- Any PowerPoint-compatible software
## Technology Stack
- **Frontend**: Next.js 15, React 19, Tailwind CSS
- **AI Integration**: Vercel AI SDK with Google Gemini 2.5 Pro
- **UI Components**: Custom components with Framer Motion animations
- **Icons**: React Icons (Feather Icons)
- **Styling**: Tailwind CSS with custom animations and effects
- **Document Integration**: Google Sheets/Docs API integration
## Architecture
### Core Components
- **SuperAgent**: Main chat interface with AI assistant
- **PPTCreator**: Dedicated presentation creation interface
- **GoogleSheetsAgent**: Specialized Google Sheets integration
- **Navigation**: Tab-based navigation between different features
### API Endpoints
- `/api/superagent`: Main AI assistant endpoint
- `/api/generate-slides`: Slide content generation
- `/api/convert-to-ppt`: PowerPoint file creation
- `/api/google-sheets-agent`: Google Sheets analysis
- `/api/connection/google-sheet`: Google Sheets connection
- `/api/connection/google-docs`: Google Docs connection
### Key Features
- **URL Detection**: Automatically detects Google Sheets/Docs URLs in chat
- **Sidebar Rendering**: Dynamic sidebar for document viewing
- **Slide Generation**: AI-powered presentation creation
- **Real-time Chat**: Interactive conversation with message history
- **Responsive Design**: Works across all device sizes
## Customization
### Adding New Tools
You can extend the available tools by modifying the `agentTools` array in `app/components/SuperAgent.tsx`:
```typescript
const agentTools = [
{ id: 'general', name: 'General Assistant', icon: FiMessageSquare },
{ id: 'slides', name: 'Presentation Creator', icon: FiSliders },
// Add new tools here
];
```
### Styling
Modify the slide styles in `app/api/convert-to-ppt/route.ts` to change presentation appearance.
### UI Components
Customize the interface by modifying components in `app/components/` and `components/ui/`.
## Contributing
1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Test thoroughly
5. Submit a pull request
## License
This project is open source and available under the [MIT License](LICENSE).
## Support
If you encounter any issues or have questions, please open an issue on GitHub.
---
**Note**: This application requires an active internet connection to generate content using the Gemini AI API and to connect to Google services.