If you want to build your first AI agent on Windows safely without affecting your main Python installation, this is the cleanest way.

---

1. Create your project folder(Command Prompt / PowerShell)

This creates a new workspace for your AI project.

mkdir ai-agent

---

2. Move into your project folder

Enter your project directory.

cd ai-agent

Think of this as entering your AI workshop.

---

3. Create a virtual environment(Important for safety)

This creates a private Python environment for your project.

It protects your main Python installation from package conflicts.

python -m venv venv

This creates:

ai-agent\
└── venv\

Why this matters:

Without it, installing packages can break:

• global Python packages
• other projects
• dependency versions

With it, your project stays isolated.

---

4. Activate the virtual environment

On Windows:

venv\Scripts\activate

After activation you should see:

(venv) C:\Users\YourName\ai-agent>

That means your isolated environment is active.

---

5. Install Google ADK

Install the toolkit:

pip install google-adk

This installs only inside your venv.

---

6. Create your Python file

Create your agent file:

type nul > agent.py

Or create it manually inside your editor.

---

7. Open your project in Cursor / VS Code

Open the whole:

ai-agent

folder.

Then open:

agent.py

Paste:

from google.adk.agents import Agent

root_agent = Agent(
    name="hello_agent",
    model="gemini-2.0-flash",
    instruction="You are a helpful AI assistant."
)

Save it.

---

8. Add your Google API key

Connect your agent to Google Gemini:

set GOOGLE_API_KEY=your_key_here

Replace with your real API key.

Important:

This only works for the current terminal session.

---

9. Start your AI agent

Run:

adk web

This launches the local web interface.

---

10. Open in browser

Go to:

http://localhost:8000

Your AI agent is now live.

You can chat with it directly.

---

What you built

You now have:

✅ Your first AI agent
✅ Running locally on Windows
✅ Connected to Google Gemini
✅ Protected inside an isolated Python environment
✅ Ready to expand with APIs, tools, memory, and workflows

Think of it like:

• Project folder = workshop
• venv = protected lab
• agent.py = brain
• API key = power source
• adk web = engine
• localhost = control center

Important safety rules

🚫 Never share your API key
🚫 Never install packages globally unless needed
🚫 Never skip the virtual environment
🚫 Avoid pip install outside venv