File size: 2,285 Bytes
e2da4c1
c4d4675
 
e2da4c1
 
ad549e8
 
 
 
 
e2da4c1
c4d4675
e2da4c1
ad549e8
 
c4d4675
 
 
 
 
 
ad549e8
 
c4d4675
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
---
title: botty-mcbotface
app_file: main.py
sdk: gradio
sdk_version: 5.12.0
license: mit
emoji: 😻
colorTo: blue
pinned: true
short_description: πŸ’¬ Just what you needed, another AI chatbot 🀦
---
# πŸ€– Botty McBotface

[![GitHub](https://img.shields.io/badge/GitHub-Repository-black?logo=github)](https://github.com/tsilva/botty-mcbotface)   [![Hugging Face Spaces](https://img.shields.io/badge/%F0%9F%A4%97%20Hugging%20Face-Spaces-blue)](https://huggingface.co/spaces/tsilva/botty-mcbotface/)

<p align="center">
  <img src="logo.png" alt="Botty McBotface Logo" width="400"/>
</p>

> πŸ’¬ Just what you needed, another AI chatbot trying to remember things and use tools without breaking everything 🀦

πŸš€ Try it out on [Hugging Face Spaces](https://huggingface.co/spaces/tsilva/botty-mcbotface/)

## ✨ Features

- 🧠 Long-term memory system
- πŸ› οΈ Integrated tools support
- 🌍 Location awareness
- 🌀️ Weather information
- πŸ” Place search capabilities
- πŸ–₯️ Gradio-powered GUI

## πŸ› οΈ Installation

1. Clone this repository:
   ```sh
   git clone https://github.com/tsilva/botty-mcbotface.git
   ```
2. Navigate to the project directory:
   ```sh
   cd botty-mcbotface
   ```

## Environment Setup

The project uses a Conda environment defined in `environment.yml`. To set up and activate the environment:

1. Ensure you have Miniconda or Anaconda installed
2. **IMPORTANT:** You must SOURCE the activation script (do not run with bash/sh):
   ```bash
   source activate-env.sh
   # or
   . activate-env.sh
   ```

⚠️ Running with `bash activate-env.sh` or `./activate-env.sh` will not work!

The script will:
- Check for Miniconda installation
- Create the environment if it doesn't exist
- Activate the environment automatically

Note: Using `./activate-env.sh` won't work as the script needs to be sourced to modify your current shell environment.

## πŸš€ Usage

1. Run the chatbot:
   ```sh
   python main.py
   ```

2. For development with auto-reload:
   ```sh
   gradio main.py
   ```
   This will automatically restart the app when you make changes to the source files.

3. Interact with the chatbot through the GUI.

## πŸ“„ License

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