Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2 Commits
 
 
 
 
 
 
 
 

Repository files navigation

🦩 Chatlama - Ollama Model Chat Interface

Chatlama is a user-friendly Streamlit app that allows you to interact with locally running Ollama language models. You can upload Word documents, ask questions based on the content, and monitor model performance and system metrics—all in one elegant UI.


🚀 Features

  • 🔍 Select any local Ollama model via dropdown
  • 💬 Chat with the selected model directly
  • 📄 Upload .docx documents and ask questions based on their content
  • ⏱️ Displays response time and total time
  • 🖥️ Shows system info (CPU, memory, OS, usage) in the sidebar

⚙️ Prerequisites

Make sure you have the following before running the app:

  1. Install Ollama
  2. Start the Ollama server:
    ollama serve
  3. Pull a model (e.g., LLaMA 3):
    ollama pull llama3

💪 Installation

1. Clone the repository

git clone https://github.com/codersbranch/Chatlama.git
cd Chatlama

2. Create a virtual environment (optional but recommended)

python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

3. Install dependencies

pip install -r requirements.txt

4. Run the Streamlit app

Make sure Ollama is running locally on port 11434 with your models loaded.

streamlit run app.py

📾 Requirements

  • Python 3.8+
  • Ollama running locally with at least one model loaded (e.g., llama3)
  • Word documents (.docx) for document-based Q&A

📁 Project Structure

chatlama/
├── app.py                 # Main Streamlit app
├── requirements.txt       # Required Python packages
└── README.md              # Project documentation

🙌 Acknowledgements


📜 License

MIT License – feel free to use, modify, and distribute.


🔗 Connect

Built with ❤️ to explore local LLMs. For questions or collaboration, feel free to reach out!

About

No description, website, or topics provided.

Resources

Stars

1 star

Watchers

1 watching

Forks

Releases

Packages

Used by

Contributors

Languages