Oraicle-Agent — Turn any Google-ADK Agent into a root_agent dynamically.
Project description
🧠 Oraicle-Agent
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_agentper 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
Agentcan be aroot_agentif 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
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
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
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
39f5ebfeccda0ceebc4b9abc8d5d5cde1d91f6aee69acb94c5c06ea05509fc42
|
|
| MD5 |
88efebc28ce761a12e5d4d30f9562f71
|
|
| BLAKE2b-256 |
dddbc883d8f6a2b3f888a98a0ebf6e3ee9d6ab0cb5311045f7e9c8b0845ba994
|
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
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
a06b7d45e9443ff38a0a2d02b209f3311718ec72860ee60674ae84eec7e5ce0e
|
|
| MD5 |
b58efd19bbe3f16bf8ace878dfbabd20
|
|
| BLAKE2b-256 |
6f0b3a869451adf7c0c14aec1564a3881a3ac2d7326b9f367f668bf1135241c4
|