https://github.com/alisson-t-bucchi/poem_generator_ai
Poem generator using AI.
https://github.com/alisson-t-bucchi/poem_generator_ai
artificial-intelligence cohere-ai personal-project python streamlit
Last synced: about 2 months ago
JSON representation
Poem generator using AI.
- Host: GitHub
- URL: https://github.com/alisson-t-bucchi/poem_generator_ai
- Owner: alisson-t-bucchi
- Created: 2025-01-13T22:20:58.000Z (9 months ago)
- Default Branch: main
- Last Pushed: 2025-01-14T22:54:24.000Z (9 months ago)
- Last Synced: 2025-01-22T02:24:07.065Z (9 months ago)
- Topics: artificial-intelligence, cohere-ai, personal-project, python, streamlit
- Language: Python
- Homepage:
- Size: 2.6 MB
- Stars: 0
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# 🤖 AI Poem Generator
This project is an AI-based poem generator built with [Cohere API](https://cohere.ai/) and [Streamlit](https://streamlit.io/).
It allows users to create personalized poems based on a theme and the desired number of lines.
## 📝 Features
- Generate custom poems based on a provided theme.
- Specify the number of lines in the poem.
- Interactive user interface built with Streamlit.
## 🚀 How to Run
### Prerequisites
Ensure you have the following dependencies installed:
- Python 3.8 or higher
- Python libraries:
- `cohere`
- `streamlit`
### Installation
1. Clone this repository:
```bash
git clone https://github.com/your-username/ai-poem-generator.git
cd ai-poem-generator
```
2. Install the required dependencies:
```bash
pip install -r requirements.txt
```
3. Create a config.py file in the root directory and add Cohere API key:
```python
API_KEY = "your_cohere_api_key"
```
### Running the Application
1. Start the Streamlit app:
```bash
streamlit run .py
```
2. Open the generated link in your terminal (usually http://localhost:8501) in a web browser.
### ⚙️ How to Use
1. Enter the desired number of lines for your poem.
2. Enter a theme for your poem (e.g., love, nature, dreams).
3. The generated poem will be displayed on the screen.
### 🛠 Technologies Used
- Cohere API: For AI text generation.
- Streamlit: For building the user interface.
- Python: The main programming language used in development.
### ⚠️ Error Handling
If the Cohere API returns an error, the program will display error messages in the console for debugging purposes.
### 📄 License
This project is licensed under the MIT License. See the LICENSE file for more details.
💡 Developed with ❤️ and AI by Alisson Bucchi.