https://github.com/undo76/chatbot-tui
https://github.com/undo76/chatbot-tui
Last synced: about 2 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/undo76/chatbot-tui
- Owner: undo76
- Created: 2025-05-20T07:56:49.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2025-05-22T08:16:44.000Z (about 1 year ago)
- Last Synced: 2026-04-23T01:30:51.799Z (2 months ago)
- Language: Python
- Size: 41 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Chatbot TUI
A terminal-based user interface for interacting with AI chatbots, built with [Textual](https://textual.io/).
## Features
- Clean, intuitive terminal interface
- Support for multiple AI models
- Built-in tools for:
- Executing shell commands
- Text-to-speech functionality
- Weather information retrieval
- Markdown rendering for chat messages
## Installation
```bash
# Clone the repository
git clone https://github.com/yourusername/chatbot-tui.git
cd chatbot-tui
# Install dependencies
pip install -e .
```
## Usage
```bash
# Start the chatbot application
python -m chatbot_tui.main
```
### Keyboard Shortcuts
- `Ctrl+C`: Exit the application
- `Enter`: Send message
- `Esc`: Clear input field
## Project Structure
```
chatbot_tui/
├── __init__.py
├── chatbot.css # Textual CSS styling
├── main.py # Application entry point
├── tools.py # Tool implementations
├── screens/ # Application screens
│ ├── __init__.py
│ └── chat.py # Main chat interface
└── widgets/ # Custom UI components
├── __init__.py
└── message.py # Message display widget
```
## Tools
The application includes several built-in tools:
- `execute_cmd`: Run shell commands from within the chat
- `speak`: Convert text to speech
- `get_weather`: Retrieve weather information for a location
## Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
## License
[MIT License](LICENSE)