Quick setup — 5 minutes

Welcome to Hermeez

Your infrastructure brain powered by natural language. Let's get you set up in a few simple steps.

Sign Up
Organization
Workspace
Datasource
Start Chatting
1

Create Your Account

Sign up or log in to get started with Hermeez

How to sign up
🌐

Visit Hermeez

Go to hermeez.ai and click Get started or Log in → in the top right corner.

🔑

Choose your auth method

Sign in using Google, GitHub, or GitLab — or create an account with your email and password.

📋

Fill in your details

If using email, enter your address and create a secure password. Check Remember me to stay signed in.

Access your dashboard

Once authenticated, you'll land on your organization dashboard — ready to set up your infrastructure.

💡

Using a social login (Google, GitHub, GitLab) is the fastest way to get started — no password to remember.

2

Set Up Your Organization

Organizations group your team, workspaces, and resources

Getting organized
🏢

Create or join an organization

After logging in, you'll see your organizations. Click + Create organization to start fresh, or select an existing one if you've been invited.

✏️

Name your organization

Choose a name that reflects your team or company. You can add a description later to help team members understand its purpose.

👥

Invite team members (optional)

Add colleagues by email to collaborate on infrastructure management. You can always invite more people later.

💡

Organizations are the top-level container. Think of them as your company or team — workspaces and datasources live inside them.

3

Create a Workspace

Workspaces separate environments like dev, staging, and production

Workspace setup

Create a new workspace

From your organization dashboard, click + Create workspace in the Workspaces panel on the right.

📝

Name & describe it

Give your workspace a clear name (e.g., test-environment). The URL identifier is generated automatically. Add a description to explain its purpose.

🔀

Select the environment type

Choose between Development, Staging, or Production. This labels how the workspace is used and helps organize your infrastructure tiers.

Confirm creation

Review your settings and click Create Workspace. You can create additional workspaces any time from the dashboard.

💡

Start with a Development workspace to experiment safely. You can always add Staging and Production workspaces later when you're ready.

4

Connect a Datasource

Import your infrastructure state from Terraform or directly from the cloud

Connecting your infrastructure
📂

Choose your source type

Select Terraform State to sync from existing state files, or Cloud Resource for direct sync from cloud provider APIs (AWS, GCP, Azure).

⚙️

Configure import settings

For cloud resources, choose your import method: AWS Role ARN Cloud Sync, GCP Credentials, or Azure Credentials. Name your datasource and assign it to a workspace.

🔐

Enter credentials

Provide the required credentials — for AWS, enter your Role ARN and Region. Click How to create AWS Role? if you need help setting up the IAM role.

🔌

Test & create

Click Test Connection to verify everything works. Once successful, hit + Create Datasource to start syncing your infrastructure.

💡

Always test the connection before creating the datasource. This ensures your credentials are valid and Hermeez can read your infrastructure state.

5

Start Chatting!

Use natural language to query and manage your infrastructure

Your AI infrastructure assistant
💬

Open a new chat

From the sidebar, click + New chat or use the input bar at the top that says Ask about your infrastructure...

🧠

Ask anything about your infrastructure

Use natural language to explore your resources, find cost optimizations, detect drift, or get insights. No need to write code or remember CLI commands.

💡

Try starting with questions like "Show me all running EC2 instances", "What's my monthly cloud spend?", or "Are there any security group misconfigurations?"

How many EC2 instances are running in us-east-1?
You have 12 EC2 instances running in us-east-1 across 3 workspaces. 4 are t3.medium, 5 are t3.large, and 3 are m5.xlarge. Would you like a cost breakdown?
Ask about your infrastructure...

You're All Set!

Your Hermeez account is configured and ready. Start asking questions about your infrastructure using natural language.