Skip to main content

Oraicle-Agent — Turn any Google-ADK Agent into a root_agent dynamically.

Project description

🧠 Oraicle-Agent

alt text

Turn any Google-ADK Agent into a Root Agent - instantly.

Oraicle-Agent is a groundbreaking Python library that extends the Google Agent Development Kit (Google-ADK), enabling any agent to become a root_agent dynamically, without hacks, forks, or duplicated apps.

This unlocks a new architectural paradigm for multi-agent systems:

  • Multiple conversational entrypoints
  • Direct chat with sub-agents
  • True Agent-to-Agent (A2A) orchestration
  • Seamless deployment on Vertex AI Agent Engine

🚀 Why Oraicle-Agent exists

Google-ADK assumes:

  • One root_agent per application
  • Sub-agents can’t be direct entrypoints
  • One conversational domain per deployment

Oraicle-Agent breaks this limitation - intentionally and cleanly.

With Oraicle-Agent, any agent can become the root of a conversation, while still participating in a larger A2A system.

🔥 This is not a hack.
🔥 This is not a fork.
🔥 This is a new abstraction layer.


✨ What makes Oraicle-Agent unique?

✅ Dynamic Root Agents

Choose at runtime which agent owns the conversation.

✅ Direct Sub-Agent Chat

Users can talk directly to a specialized agent (teacher, assistant, expert) without losing context isolation.

✅ A2A-First Architecture

Root agents orchestrate other agents, while still being callable as standalone conversational entities.

✅ Google-ADK & Vertex AI Compatible

Works with:

  • adk web
  • ADK loader
  • Vertex AI Agent Engine

🧩 The core idea (one line)

Any Agent can be a root_agent if it is explicitly declared as one.

Oraicle-Agent formalizes this idea.


📦 Installation

pip install oraicle

⚡ Quick Start

from oraicle import autoagent
from google.adk.agents import Agent

history_teacher = Agent(
    name="history_teacher",
    model="gemini-2.0-flash",
    instruction="You are a history teacher."
)

autoagent(history_teacher)

☁️ Deploying to Vertex AI Agent Engine

from app.sub_agents.history_teacher.agent import history_teacher

📄 License

MIT License © 2026
Built with 🤖 for the GenAI community.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

oraicle-1.0.0.tar.gz (5.1 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

oraicle-1.0.0-py3-none-any.whl (6.3 kB view details)

Uploaded Python 3

File details

Details for the file oraicle-1.0.0.tar.gz.

File metadata

  • Download URL: oraicle-1.0.0.tar.gz
  • Upload date:
  • Size: 5.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.7

File hashes

Hashes for oraicle-1.0.0.tar.gz
Algorithm Hash digest
SHA256 39f5ebfeccda0ceebc4b9abc8d5d5cde1d91f6aee69acb94c5c06ea05509fc42
MD5 88efebc28ce761a12e5d4d30f9562f71
BLAKE2b-256 dddbc883d8f6a2b3f888a98a0ebf6e3ee9d6ab0cb5311045f7e9c8b0845ba994

See more details on using hashes here.

File details

Details for the file oraicle-1.0.0-py3-none-any.whl.

File metadata

  • Download URL: oraicle-1.0.0-py3-none-any.whl
  • Upload date:
  • Size: 6.3 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.7

File hashes

Hashes for oraicle-1.0.0-py3-none-any.whl
Algorithm Hash digest
SHA256 a06b7d45e9443ff38a0a2d02b209f3311718ec72860ee60674ae84eec7e5ce0e
MD5 b58efd19bbe3f16bf8ace878dfbabd20
BLAKE2b-256 6f0b3a869451adf7c0c14aec1564a3881a3ac2d7326b9f367f668bf1135241c4

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page