Loading repository data…
Loading repository data…
Rohit10jr / repository
This project is a conversational AI agent built using Google's Agent Developer Kit to validate HSN codes and return related details from a master file.
A transparent discovery signal based on current public GitHub metadata.
This score does not audit code, security, maintainers, documentation quality, or suitability. Verify the repository and its current documentation before adoption.
This project implements an HSN (Harmonized System of Nomenclature) code validation agent using the Google ADK (Agent Development Kit) framework. The agent loads a master HSN code Excel file, provides a tool for validating HSN codes, and includes guardrails for both model and tool calls. It is designed to be run as an ADK agent with a web interface for interactive use.
For more detailed explanations, diagrams, and examples, see the docs/ folder:
index.md: Detailed project overview, structure, and design.index_diagrams.md: Architecture diagrams and data flow illustrations.You can explore these files directly in the repository or view them rendered on GitHub.
HSN_SAC.xlsx).adk web command..
├── data/
│ └── HSN_SAC.xlsx # Master Excel file with HSN codes and descriptions
├── docs/
│ └── index.md # Documentation placeholder
├── hsn_agent/
│ ├── __init__.py # Package initializer
│ ├── agent.py # Agent setup and orchestration
│ ├── callback.py # Guardrails and tool callbacks
│ ├── data_loader.py # Loads and prepares HSN/SAC data
│ ├── tool.py # Defines tools for HSN validation
│ └── .env/ # Environment variables (API keys, configs)
├── requirements.txt # Main Python dependencies requirements list
├── .gitignore # Git ignore rules
├── readme.md # This file
└── venv/ # virtual environment
data/HSN_SAC.xlsx into memory for fast lookup.hsn_code_validation_tool) to validate HSN codes (numeric, 2/4/6/8 digits, must exist in master data).git clone https://github.com/Rohit10jr/google_adk_hsn_agent.git
cd google_adk_hsn_agent
python -m venv venv
.\venv\Scripts\Activate
pip install -r requirements.txt
HSN_SAC.xlsx file in the data/ directory.HSNCode and Description.hsn_agent/agent.py.You can start the agent using either the direct ADK command or the provided script:
adk web
adk api_server
chmod +x command.sh
./command.sh run
This will activate your virtual environment and launch the ADK web UI for interacting with your agent.
./command.sh server
This will start the ADK API server for programmatic access.
agent.py to customize the agent’s behavior, tool usage, and overall validation flow.callback.py to update tool guardrails, block rules, or response formatting.data_loader.py to change how HSN/SAC data is loaded or preprocessed.tools.py — such as HSN code validation or future utilities.ToolContext; replace with persistent storage for production use.HSN_SAC.xlsx, ensure the file exists in data/ and has the correct columns.requirements.txt and reinstall as needed.This project is for demonstration and internal use. See the repository or ADK for license details.