https://github.com/yogya-coder/termbots

Ollama powered terminal based ai chatbot(s)
https://github.com/yogya-coder/termbots

chatbot-application langchain-python ollama pip python terminal-app

Last synced: 4 months ago
JSON representation

Ollama powered terminal based ai chatbot(s)

• Host: GitHub
• URL: https://github.com/yogya-coder/termbots
• Owner: yogya-coder
• License: mit
• Created: 2025-03-06T08:40:28.000Z (4 months ago)
• Default Branch: main
• Last Pushed: 2025-03-06T10:00:52.000Z (4 months ago)
• Last Synced: 2025-03-06T10:23:44.652Z (4 months ago)
• Topics: chatbot-application, langchain-python, ollama, pip, python, terminal-app
• Language: Python
• Homepage:
• Size: 7.81 KB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# TERMBOTS

[![GitHub](https://img.shields.io/badge/Visit-GitHub-black?style=for-the-badge&logo=github)](https://github.com/yogya-coder/Termbots)  

[![Python](https://img.shields.io/badge/Python-3.12.9-blue?style=for-the-badge&logo=python)](https://www.python.org/)  

[![Pip](https://img.shields.io/badge/Pip-25.0.1-brightgreen?style=for-the-badge)](https://pip.pypa.io/)  

[![Ollama](https://img.shields.io/badge/Ollama-Server-blueviolet?style=for-the-badge)](https://ollama.com/)  

[![LangChain](https://img.shields.io/badge/LangChain-Community-critical?style=for-the-badge)](https://python.langchain.com/)  

[![Rich](https://img.shields.io/badge/Rich-10.0.0-blueviolet?style=for-the-badge)](https://github.com/willmcgugan/rich)

A **terminal chatbot** built using **LangChain Core Templates**, **Ollama**, and **Rich**. This project provides an interactive, context-aware chat interface right in your terminal, complete with advanced commands, conversation history, logging, and dynamic prompt generation.

---

## Overview

This terminal chatbot allows you to:

- Interact with a large language model via the Ollama server.

- Enjoy a colorful terminal UI powered by Rich.

- Maintain context with recent conversation history using LangChain prompt templating.

- Use advanced commands such as `help`, `history`, `reset`, `clear`, and `exit`.

- Change the template in `main.py` to suit your needs.

---

## Prerequisites

- **Ollama Server:**  

  Make sure you have the [Ollama](https://ollama.com/) installed and running on your system.

  

- **System Requirements for Ollama:**  

  The required model for Ollama full may need a specific amount of RAM. Ensure your system meets the necessary RAM requirements for the model you plan to use.

- **Python 3.12.9 (for no errors) & pip 25.0.1 or higher**

- **git**

	for cloning the repo

- **cmake build tools (optional)**

	for generating metadata and wheels for pydantic-core & many modules.

---

## Installation

1. **Clone the Repository**

   ```bash

   git clone https://github.com/yogya-coder/Termbots/

   cd Termbots

   pip install -r libs.txt

   ollama serve

   # in a new terminal run :

   cd Termbots

   python main.py

   ```

---

### How to run it in Termux:

> - Install termux from f-droid

> - **Run the commands below:**

```bash

pkg update && pkg upgrade -y

termux-setup-storage

termux-change-repo # choose the `mirror groups` & `all mirrors in aisa` then `ok`

pkg install rust clang cmake binutils python ollama tur-repo -y # you can also install ollama from there github repo also

# installed additional packages for error free installation of all modules 

pkg install git wget -y

git clone https://github.com/yogya-coder/Termbots.git

cd Termbots

pip install -r libs.txt

ollama serve

# in a new session

cd Termbots

python main.py

```