Skip to content

avalon60/Orac

Repository files navigation

Orac Logo

Orac - Version 0.1.0

Your retro-futuristic home AI assistant.

Python 3.9+ License Build Status


✨ Features (currently a roadmap)

  • 🎤 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.

📂 Quick Links


📦 Installation

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)


🛢 Oracle Free Setup

Orac uses an Oracle Database for configuration and metadata storage. To get started:

Install Oracle Free (23ai)

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

⚠️ Change credentials for production use.


Create Orac User & Schema

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.


🛠 Usage

Start Orac with:

python -m orac

(Describe how to configure Raspberry Pi satellites and connect to your home network.)


📄 License

This project is licensed under the MIT License - see the LICENSE file for details.


🤖 About the Name

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."