https://github.com/mohd-faizy/deepchat

A Streamlit-powered Chat Assistant utilizing Ollama's DeepSeek-R1 (1.5B) model for intelligent, context-aware conversations. Designed with an interactive chat interface, adjustable model parameters. It leverages Ollama for local model serving and Streamlit for a responsive UI for text-based interactions.
https://github.com/mohd-faizy/deepchat

deepseek deepseek-chat deepseek-r1 llm ollama python streamlit

Last synced: 2 months ago
JSON representation

Host: GitHub
URL: https://github.com/mohd-faizy/deepchat
Owner: mohd-faizy
License: mit
Created: 2025-01-30T22:16:09.000Z (over 1 year ago)
Default Branch: main
Last Pushed: 2025-01-30T23:08:41.000Z (over 1 year ago)
Last Synced: 2025-03-28T02:51:44.974Z (about 1 year ago)
Topics: deepseek, deepseek-chat, deepseek-r1, llm, ollama, python, streamlit
Language: Python
Homepage:
Size: 139 KB
Stars: 2
Watchers: 1
Forks: 1
Open Issues: 0
Metadata Files:
- Readme: README.md
- License: LICENSE

Awesome Lists containing this project

README

          # 🤖 DeepChat

[![author](https://img.shields.io/badge/author-mohd--faizy-red)](https://github.com/mohd-faizy)

[![Streamlit](https://img.shields.io/badge/Streamlit-FF4B4B?logo=streamlit&logoColor=white)](https://streamlit.io)

[![Ollama](https://img.shields.io/badge/Ollama-0C0D0E?logo=ollama&logoColor=white)](https://ollama.ai)

[![Python 3.9+](https://img.shields.io/badge/Python-3.9%2B-3776AB?logo=python&logoColor=white)](https://python.org)

DeepChat is an AI-powered chatbot leveraging `DeepSeek-R1` (1.5B) parameters, built with `Streamlit` and `Ollama` for seamless and interactive conversations.

![Demo](https://github.com/mohd-faizy/DeepChat/blob/main/assets/deepChat.png?raw=true)

## Directory Structure

```

deepchat/

├── app/

│   ├── __init__.py

│   ├── main.py          # Streamlit application

│   └── utils.py         # Helper functions

├── assets              

├── requirements.txt     # Python dependencies

├── .gitignore

├── README.md            

```

## 🚀 Quick Start

### Prerequisites

- Python 3.9+

- [Ollama](https://ollama.ai/) installed and running

- DeepSeek-R1 model:

  ```bash

  ollama pull deepseek-r1:1.5b

  ```

### Installation

1. Clone repository:

   ```bash

   git clone https://github.com/mohd-faizy/DeepChat.git

   ```

2. Create virtual environment:

   ```bash

   python -m venv venv

   ```

3. Activate environment:

   ```bash

   # Linux/macOS

   source venv/bin/activate

   

   # Windows

   .\venv\Scripts\activate

   ```

4. Install dependencies:

   ```bash

   pip install -r requirements.txt

   ```

### 🖥️ Usage

1. Start Ollama service:

   ```bash

   ollama serve

   ```

2. In a separate terminal, launch the chat interface:

   ```bash

   streamlit run app/main.py

   ```

## 🔧 Troubleshooting

**Port Conflict (11434):**

```bash

# Windows

netstat -ano | findstr :11434

taskkill /PID  /F

# Linux/macOS

lsof -i :11434

kill -9 

```

**Common Issues:**

- Ensure Ollama is running before launching the Streamlit app

- Verify model installation: `ollama list`

- Check firewall settings if experiencing connection issues

## 🍰 Contributing

Contributions are welcome!

## ⚖ ➤ License

This project is licensed under the MIT License. See [LICENSE](LICENSE) for details.

## ❤️ Support

If you find this repository helpful, show your support by starring it! For questions or feedback, reach out on [Twitter(`X`)](https://twitter.com/F4izy).

## 🔗Connect with me

➤ If you have questions or feedback, feel free to reach out!!!

[][twitter]

[][linkedin]

[][Portfolio]

[twitter]: https://twitter.com/F4izy

[linkedin]: https://www.linkedin.com/in/mohd-faizy/

[Portfolio]: https://ai.stackexchange.com/users/36737/faizy?tab=profile

---

ecosyste.ms

Data

Tools

Indexes

Applications

Experiments

Awesome

https://github.com/mohd-faizy/deepchat

Awesome Lists containing this project

README