Skip to main content

Red Hat Oracle

redhat-oracle logo

AI-powered knowledge assistant for Red Hat engineering teams. Ingests GitHub/GitLab repositories, Jira issues, GitLab Pages, public web docs, and Slack conversations, indices them in a ChromaDB vector store, and provides RAG-based chat via local or cloud LLMs.

Prerequisites

  • Python 3.11+
  • Ollama running locally (recommended LLM backend)
  • Git (for cloning source repos)

Installation

# Clone the repo
git clone git@github.com:dmzoneill/redhat-oracle.git
cd redhat-oracle

# Create a virtual environment
python3 -m venv .venv
source .venv/bin/activate

# Install in development mode (with dev dependencies)
pip install -e ".[dev]"

# Or install without dev dependencies
pip install -e .

Configuration

Copy and edit the sample config:

cp oracle.yaml ~/.config/redhat-oracle/oracle.yaml

Config files are loaded and merged in order (higher precedence wins):

  1. /etc/redhat-oracle/oracle.yaml (system)
  2. ~/.config/redhat-oracle/oracle.yaml (user)
  3. ./oracle.yaml (project)

Secrets

Tokens are never stored in config files. Set them as environment variables:

export ORACLE_GITHUB_TOKEN="ghp_..."
export ORACLE_GITLAB_TOKEN="glpat-..."
export ORACLE_SLACK_TOKEN="xoxb-..."
export ORACLE_JIRA_TOKEN="..."
export OPENAI_API_KEY="sk-..."        # optional, if using OpenAI
export ANTHROPIC_API_KEY="sk-ant-..." # optional, if using Anthropic

Usage

CLI

oracle            # Start interactive chat
oracle sync       # Sync all configured sources
oracle status     # Show index status

GUI (optional)

pip install -e ".[gui]"
oracle --gui

Development

# Run tests
make test

# Lint
make lint

# Type check
make typecheck

# Build distribution
make build

Or run commands directly:

pytest tests/
ruff check src/ tests/
mypy src/

Architecture

Module Purpose
core/config.py YAML config loading with Pydantic validation
core/sources/ Data source connectors (GitHub, GitLab, Slack, Jira, Pages, Web)
core/vectordb/ ChromaDB vector store, AST-aware chunking, change tracking
core/rag.py RAG pipeline: embed query, search, assemble context, stream LLM
core/cache.py Response caching
cli/app.py Click + prompt-toolkit + Rich terminal UI
gui/app.py PySide6 (Qt) desktop GUI

License

MIT

Metadata

Release files for redhat-oracle 0.1.3

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for redhat-oracle 0.1.3
File Size Uploaded Provenance Actions
redhat_oracle-0.1.3.tar.gz 170.3 kB Without provenance Details for redhat_oracle-0.1.3.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for redhat-oracle 0.1.3
File Interpreter ABI Platform Actions
redhat_oracle-0.1.3-py3-none-any.whl Python 3 none any Details for redhat_oracle-0.1.3-py3-none-any.whl

Total release size: 244.9 kB

Release files / redhat_oracle-0.1.3.tar.gz

Download URL redhat_oracle-0.1.3.tar.gz
Size 170.3 kB
Tags Source
SHA-256 checksum
How to use checksums
523ec8d0c561b9a74027219ec2c8f2e1e638838cff1abf5a6f6793e97ef063bd
BLAKE2b-256 checksum
How to use checksums
1baf64ed11c814ad71e8fff00be2cd02bfc8b681b4b7774f1416396272fe4ff8
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.12.3

Release files / redhat_oracle-0.1.3-py3-none-any.whl

Download URL redhat_oracle-0.1.3-py3-none-any.whl
Size 74.6 kB
Tags Python 3
SHA-256 checksum
How to use checksums
347d3694e8c19d1aa7b8d3a1353ec18751ed450162786444192f778f8d466dfa
BLAKE2b-256 checksum
How to use checksums
5a0c6d3bcf42269b3ec6bb51628f2b349ac6e1522793d61ac12cfed4af18acda
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.12.3

Security for redhat-oracle 0.1.3

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page