https://github.com/rb81/convollama
A simple Python application that facilitates AI-driven conversations using Ollama.
https://github.com/rb81/convollama
ai-conversations large-language-models llama3 ollama small-language-models wizardlm2
Last synced: 5 months ago
JSON representation
A simple Python application that facilitates AI-driven conversations using Ollama.
- Host: GitHub
- URL: https://github.com/rb81/convollama
- Owner: rb81
- License: mit
- Created: 2024-07-24T12:44:21.000Z (almost 2 years ago)
- Default Branch: main
- Last Pushed: 2025-08-08T07:17:59.000Z (10 months ago)
- Last Synced: 2026-01-13T12:42:19.397Z (5 months ago)
- Topics: ai-conversations, large-language-models, llama3, ollama, small-language-models, wizardlm2
- Language: Python
- Homepage:
- Size: 4.09 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
**⚠️ DEPRECATED REPOSITORY**
This project is no longer actively maintained and may be out of date.
---
# ConvOllama
ConvOllama is a Python application that facilitates AI-driven conversations using the Ollama API. It creates engaging, multi-participant discussions on user-specified topics, with the ability to assign unique profiles to each AI participant.
## Features
- Dynamic topic generation based on user input or keywords
- Multi-participant conversations with AI-generated or user-defined profiles
- User-selectable LLM models for participants
- Configurable conversation parameters (number of participants, rounds, etc.)
- Real-time conversation display with colorized output
- Automatic saving of conversations in both JSON and Markdown formats
- Graceful handling of program interruption
- Configurable conversation history limit and logging level
## Requirements
- Python 3.7+
- Ollama API access
## Installation
1. Clone this repository:
```
git clone https://github.com/rb81/convollama.git
cd convollama
```
2. Install the required dependencies:
```
pip install -r requirements.txt
```
3. Ensure you have Ollama set up and running on your system.
## Configuration
Create a `config.yaml` file in the project root directory with the following structure:
```yaml
moderator_model: "wizardlm2:latest"
ollama_host: "http://localhost:11434"
save_path: "~/Downloads/ConvOllama"
available_models:
- "llama3.1:latest"
- "gemma2:latest"
- "falcon2:latest"
history_limit: 3 # Keep the last 3 rounds of messages
log_level: "INFO" # Can be DEBUG, INFO, WARNING, ERROR, or CRITICAL
```
Adjust the values according to your preferences and setup.
## Usage
Run the application using the following command:
```
python main.py
```
or specify a custom configuration file:
```
python main.py -c path/to/your/config.yaml
```
You will be guided through the following steps:
1. Choose the number of participants (minimum 2)
2. Select the LLM model for the participants
3. Determine the conversation topic:
- Enter keywords and have the Moderator generate a topic
- Enter a discussion topic yourself
4. For each participant:
- Provide a profile yourself
- Have the Moderator generate a profile
- Choose no profile
5. Set the number of conversation rounds
The conversation will then begin. To end the conversation early, press Ctrl+C. The program will save the conversation and exit gracefully.
## Output
Conversations are saved in two formats:
1. JSON file for easy parsing and analysis
2. Markdown file for human-readable documentation
Both files are saved in the directory specified by `save_path` in the configuration.
## Model Recommendations
The Moderator works well with `wizardlm2`. Recommended Participant models include Meta's new `llama3.1`, `gemma2`, and `llama3`. You can customize the list of available models in the configuration file.
## Demonstration
## License
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
## Transparency Disclaimer
[ai.collaboratedwith.me](https://ai.collaboratedwith.me) in creating this project.