Your retro-futuristic home AI assistant.
- 🎤 Voice-Driven AI: Natural language interaction via satellite Raspberry Pi units.
- 🧠 Conversational Intelligence: Integrated with LM Studio for cutting-edge AI responses.
- 🏠 Smart Hub Control: Manage lights, media, and IoT devices seamlessly.
- 🧩 Home Assistant Integrations: Works hand-in-hand with Home Assistant for extensive smart home control.
- 💬 Client Chatbot: Interact with Orac through a web or desktop chatbot interface.
- 🌐 Supports Multiple LLM Services: Connects to LM Studio, Ollama, OpenAI, and more.
- 🛠 Modular Design: Easily extend Orac with custom skills and automations.
- 🖥 Cross-Platform: Works with Linux Mint and other major platforms.
Clone the repository and install Orac in editable mode:
git clone https://github.com/Avalon60/orac.git
cd orac
pip install -e .
(Add any additional setup instructions here)
Orac uses an Oracle Database for configuration and metadata storage. To get started:
Follow Oracle’s instructions to install Oracle Database Free:
Alternatively, you can use a Docker container for local development:
docker run -d \
-p 1521:1521 -p 5500:5500 \
--name oracle-free \
container-registry.oracle.com/database/free:23.5.0
-
The default container uses:
- Username:
system
- Password:
oracle
- Service Name:
FREEPDB1
- Username:
⚠️ Change credentials for production use.
Log in and create a dedicated user for Orac:
CREATE USER orac IDENTIFIED BY orac_password;
GRANT CONNECT, RESOURCE TO orac;
⚠️ Adjust roles/permissions as needed.
Start Orac with:
python -m orac
(Describe how to configure Raspberry Pi satellites and connect to your home network.)
This project is licensed under the MIT License - see the LICENSE file for details.
The name Orac pays homage to the iconic AI from Blake’s 7—a nod to retro science fiction with modern AI innovation.
"Logic is a wreath of pretty flowers which smell bad."