testspace / README.md
shivay-couchbase
agent added to chat
852ea09
---
title: Startup Idea Validator
emoji: πŸš€
colorFrom: blue
colorTo: blue
sdk: docker
app_port: 8501
tags:
- streamlit
pinned: false
short_description: Discover the perfect startup ideas with AI Validation
license: mit
---
![demo](./src/assets/demo.gif)
An advanced AI-powered agentic application that validates and analyzes startup ideas through multi-stage research, competitor analysis, and comprehensive reporting. Built with Google ADK, Nebius AI, Tavily, and Streamlit.
## πŸš€ Features
- **Multi-Agent Validation**: Clarifies, researches, and analyzes startup ideas using specialized AI agents
- **Market Research**: Estimates market size, segments, and opportunities
- **Competitor Analysis**: Identifies competitors, strengths, weaknesses, and positioning
- **Comprehensive Reports**: Generates markdown-friendly validation reports for easy reading
- **Interactive Dashboard**: Streamlit UI for seamless user experience
- **API Key Management**: Securely manage Nebius and Tavily API keys via sidebar
## πŸ› οΈ Tech Stack
- **Python**: Core programming language
- **Streamlit**: Interactive web dashboard
- **Google ADK**: Agentic workflow and LLM orchestration
- **Nebius AI**: Large language model for research and analysis
- **Tavily**: Web search and data extraction
- **uv**: Fast Python package manager
- **dotenv**: Environment variable management
## πŸ“¦ Getting Started
### Prerequisites
- Python 3.9+
- [uv](https://github.com/astral-sh/uv) package manager (used instead of pip)
- [Nebius](https://dub.sh/Nebius) API key
- [Tavily](https://dub.sh/tavily) API key
### Environment Variables
Create a `.env` file in the project root with the following variables:
```env
NEBIUS_API_KEY="your_nebius_api_key"
TAVILY_API_KEY="your_tavily_api_key"
```
## πŸ“– How It Works
1. **Idea Input**: Enter your startup idea in the chat input
2. **Clarification**: The Idea Clarifier agent refines and clarifies your idea
3. **Market Research**: The Market Researcher agent analyzes market size and segments
4. **Competitor Analysis**: The Competitor Analyst agent evaluates competitors and positioning
5. **Report Generation**: The Report Generator agent synthesizes all findings into a markdown-friendly report
## 🀝 Contributing
Contributions are welcome! Please submit a pull request or open an issue to discuss changes.
## πŸ“„ License
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.