https://github.com/germanocastanho/socrates-bot
Artificial Intelligence chatbot that mimics Socrates' persona 🤔
https://github.com/germanocastanho/socrates-bot
chatgpt-4o faiss faiss-cpu faiss-vector-database gpt-4o gpt-oss gpt-oss-120b hugging-face huggingface huggingface-spaces huggingface-transformers langchain philosophy python rag rag-chatbot rag-pipeline retrieval-augmented-generation socrates undergraduate
Last synced: about 2 months ago
JSON representation
Artificial Intelligence chatbot that mimics Socrates' persona 🤔
- Host: GitHub
- URL: https://github.com/germanocastanho/socrates-bot
- Owner: germanocastanho
- License: gpl-3.0
- Created: 2025-07-23T19:47:07.000Z (11 months ago)
- Default Branch: main
- Last Pushed: 2026-01-14T04:04:53.000Z (5 months ago)
- Last Synced: 2026-01-14T08:12:03.300Z (5 months ago)
- Topics: chatgpt-4o, faiss, faiss-cpu, faiss-vector-database, gpt-4o, gpt-oss, gpt-oss-120b, hugging-face, huggingface, huggingface-spaces, huggingface-transformers, langchain, philosophy, python, rag, rag-chatbot, rag-pipeline, retrieval-augmented-generation, socrates, undergraduate
- Language: Python
- Homepage: https://huggingface.co/spaces/germanocastanho/socrates-bot
- Size: 477 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 6
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 📖 Socrates Bot
Born from reflections on the "**LabTec Cultura Digital**" course, from the [Philosophy Program](https://www.unisinos.br/graduacao/filosofia/sao-leopoldo) at UNISINOS, taught in 2025/1 by [Prof. Me. Tatiana Costa Leite](http://lattes.cnpq.br/6897855276768211), this project consists of an **Artificial Intelligence** chatbot that, mimicking **Socrates'** persona, provides users with an engaging dialogue with the philosopher! 🤔
Detail from "The Death of Socrates" by Jacques-Louis David. A classic representation of intellectual courage in the face of injustice. A timeless reminder of the transformative impact of ideas and the pursuit of truth, values that also guide technological innovation.
# 🚀 Main Features
- **Interactive Chatbot:** 🤖 Powerful tool to stimulate critical thinking and philosophical reflection.
- **Intelligent Model:** 🧠 Uses OpenAI's GPT-4o model, providing more coherent responses.
- **User-Friendly Interface:** 🎨 Interaction through a minimalist and visually appealing graphical interface.
# 🤗 Hugging Face
To facilitate experimentation, the project is also available on the Hugging Face platform, allowing anyone to interact with the chatbot efficiently, without the need for local installation. Simply access [**this link**](https://huggingface.co/spaces/germanocastanho/socrates-bot) and start philosophizing with Socrates! 💭
# ✅ Prerequisites
- **Python 3.12+**, available through the [**official website**](https://www.python.org/downloads/).
- **OpenAI API key**, accessible through the [**platform**](https://platform.openai.com/login).
- `.env` file with the **`OPENAI_API_KEY` variable** configured.
# 🛠️ Local Installation
```bash
# Clone the repository
git clone https://github.com/germanocastanho/socrates-bot.git
# Navigate to the directory
cd socrates-bot
# Set up a virtual environment
python3 -m venv .venv
source .venv/bin/activate
# Install dependencies
pip install -r requirements.txt
# Set up your API key
echo "OPENAI_API_KEY=YOUR_API_KEY" > .env
# Run the "demo.py" script
python3 demo.py
```
# 📜 Free Software
Distributed under the [**GNU GPL v3**](LICENSE), ensuring freedom to use, modify, and redistribute the software, as long as these freedoms are preserved in any derivative versions. By using or contributing, you support the **free software** philosophy and help build an open, community-driven technological environment! ✊