---
license: apache-2.0
---
# Capybara Agent: AI-Powered Personality Quiz

Capybara Agent is an AI-powered conversational agent that utilizes carefully curated knowledge from enneagram, Big Five, and other personality frameworks to dynamically generate personalized questions, analyze user responses, and produce nuanced personality classifications through an interactive frontend.
## Introduction Video

[![Capybara Agent Introduction](https://img.youtube.com/vi/Zn7A01MHLOw/0.jpg)](https://www.youtube.com/watch?v=Zn7A01MHLOw)

## Features

- AI-powered Capybara Agent generates tailored questions based on previous responses
- Personality classification by the Capybara Agent based on user answers
- Saves personality summaries to text files
- Interactive web interface featuring the Capybara Agent

## Requirements

- Python 3.8+
- Flask
- Flask-CORS
- LangChain
- Capx API key

## Installation

1. Clone this repository:
   ```
   git clone https://github.com/yourusername/capybara-agent.git
   cd capybara-agent
   ```
2. Install the required packages:
   ```
   pip install -r requirements.txt
   ```
3. Set your OpenAI API key as an environment variable:
   ```
   export Capx_API_KEY='your-api-key-here'
   ```

## Usage

1. Start the Capybara Agent server:
   ```
   python capybara_agent.py
   ```
2. Open `capybara_agent.html` in your web browser.
3. Interact with the Capybara Agent by answering its questions.
4. After answering 5 questions, you'll receive your personality classification from the Capybara Agent.
5. A summary of your responses and personality classification will be saved as a text file in the project directory.

## File Structure

- `capybara_agent.py`: Flask backend with Capybara Agent logic
- `capybara_agent.html`: Frontend HTML/JavaScript featuring the Capybara Agent
- `requirements.txt`: List of Python dependencies
- `README.md`: This file
- `capybara.mp4`: Introductory video about the Capybara Agent

## Contributing

Contributions to improve the Capybara Agent are welcome! Please feel free to submit pull requests or open issues to discuss potential enhancements.

## License

This project is licensed under the Apache 2.0 License - see the [LICENSE](LICENSE) file for details.