Turn Giotto into a Claude Code–style AI assistant for your computer!
By connecting Hermes Agent to Giotto, you can use Giotto models directly from your terminal, with access to powerful agentic tools.
Instead of simply chatting with an AI model, you can ask Giotto to:
- Read, create, and edit files on your computer.
- Write, explain, and debug code in your local projects.
- Execute terminal commands and run scripts.
- Search the web and retrieve information using configured web tools.
- Perform multi-step tasks autonomously, combining different tools.
Hermes provides the agent and tools, while Giotto provides the intelligence through its AI models.
No local GPU or model installation is required!
Step 1 - Get your Giotto API credentials
First, you need a Giotto account with API access.
- Visit Giotto.
- Activate API access and obtain your Client ID and Client Secret.
-
Combine the two values using a colon (
:) in this format:your-client-id:your-client-secret
This combined value is your API key when connecting OpenAI-compatible applications to Giotto.
For additional information, see Connect OpenAI-Compatible Tools to Giotto.
Step 2 - Install Hermes Agent
Hermes is an open-source AI agent developed by Nous Research.
It supports macOS, Linux, and Windows.
macOS / Linux / Windows WSL2
Open a terminal and run:
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
Once installation completes, restart your terminal or reload your shell:
source ~/.zshrc
On Linux systems using Bash, use source ~/.bashrc instead.
Windows (PowerShell)
Open PowerShell and run:
iex (irm https://hermes-agent.nousresearch.com/install.ps1)
Restart PowerShell once the installation completes.
Verify the installation
Execute:
hermes --help
If the installation was successful, Hermes will display its available commands.
Step 3 - Connect Hermes to Giotto
Run the following command in your terminal:
hermes model
Hermes will open an interactive configuration wizard.
Select:
Custom endpoint (self-hosted / vLLM / etc.)
Enter the following configuration:
| Setting | Value |
|---|---|
| Provider | Custom endpoint |
| Base URL | https://cloud.giotto.ai/v1 |
| API key | your-client-id:your-client-secret |
| Model name | giotto-alto |
You can also use giotto-solo instead of giotto-alto.
Both models are accessible through Giotto's OpenAI-compatible API.
If Hermes asks for an API format, choose OpenAI Chat Completions. If it asks for the context length, use the actual context size supported by the selected model and endpoint (Hermes requires at least 64K tokens).
Complete the wizard to save your settings.
That's it! Hermes is now configured to use Giotto.
Step 4 - Start using Giotto in your terminal
Start Hermes:
hermes --tui
This launches Hermes' interactive terminal interface.
Alternatively, you can use:
hermes
You can now ask questions such as:
Explain the architecture of this Python project.
Find potential bugs in my code and suggest improvements.
Create a Python script that processes CSV files.
List the files in my current directory and explain their purpose.
Hermes will use the configured Giotto model to understand your requests and determine which tools to invoke.
Step 5 - Let Giotto read your local files
One of the most useful capabilities of Hermes is its ability to work directly with files on your computer.
Let's test it!
Create a test folder
On macOS or Linux, run:
mkdir -p ~/giotto-hermes-demo echo "Hello from Giotto!" > ~/giotto-hermes-demo/test.txt
Navigate to the folder:
cd ~/giotto-hermes-demo
On Windows PowerShell, you can create the same test using:
mkdir "$HOME\giotto-hermes-demo" -Force "Hello from Giotto!" | Set-Content "$HOME\giotto-hermes-demo\test.txt" cd "$HOME\giotto-hermes-demo"
Start Hermes in this folder
hermes --tui
Now type:
List all the files in my current directory. Open test.txt and tell me exactly what it contains. Please use your file tools to read it and do not modify any files.
Hermes should discover the file, read its contents, and report:
Hello from Giotto!
Congratulations! You now have a Giotto-powered agent that can interact with files on your computer.
You can repeat the same process with one of your existing coding projects.
Important: By default, Hermes uses the local terminal backend. Its file and terminal tools run with your operating-system user's permissions. Starting Hermes inside a particular directory does not restrict its access to that directory.
Step 6 - Enable additional tools
Hermes comes with multiple tools that extend the capabilities of the underlying Giotto model.
To configure them, exit Hermes and run:
hermes tools
From the configuration interface, you can enable or disable tools for file operations, terminal execution, web search, browser automation, memory, and other functions.
Some tools, particularly web search and third-party integrations, may require additional API keys or configuration.
These tools are provided by Hermes and operate independently from your Giotto API subscription.
Step 7 - Change your Giotto model
Want to switch from giotto-alto to giotto-solo, or vice versa?
Simply execute:
hermes model
Select your Giotto endpoint and configure the model you want to use.
Inside an active Hermes session, you can also use /model to switch between previously configured models.
Optional - Configure Hermes manually
Advanced users can configure Hermes by editing its configuration files directly.
Open:
hermes config edit
In ~/.hermes/config.yaml, configure:
model: provider: custom default: giotto-alto base_url: https://cloud.giotto.ai/v1 key_env: GIOTTO_API_KEY terminal: backend: local
Then add the following entry to ~/.hermes/.env:
GIOTTO_API_KEY=your-client-id:your-client-secret
Replace the example credentials with your actual values. Keep this file private and never commit it to a Git repository.
You can verify your configuration with:
hermes doctor
The interactive wizard in Step 3 is recommended for most users.
Security and privacy considerations
Hermes is a third-party application that runs on your computer. When using it with Giotto:
- The Giotto model performs inference remotely through the configured API.
- Hermes executes local file and terminal tools on your computer.
- File contents and tool results may be sent to the Giotto model as part of your requests.
- Local tools may read, modify, or delete files accessible to your operating-system account.
- Optional third-party tools may send data to additional services.
For sensitive projects, consider configuring Hermes to execute commands inside an isolated Docker environment with only the necessary directories mounted.
For more information, see the Hermes configuration documentation.
Troubleshooting
Hermes returns an authentication error (401 or 403)
Verify that your API key contains both the Giotto Client ID and Client Secret separated by a colon. Also confirm that your API access is active.
Hermes cannot find the model
Verify that the model name is exactly giotto-alto or giotto-solo and that the base URL is https://cloud.giotto.ai/v1.
Hermes can chat but cannot access local files
Run hermes tools and verify that File Operations and Terminal tools are enabled. Check local permissions and, if using Docker, confirm the directory is mounted.
Hermes answers questions but does not execute tools
Tool execution requires the selected model and API endpoint to support compatible tool calling. Check the Hermes logs and confirm that tool calls are being generated and accepted.
You're ready!
You now have a Claude Code–style terminal assistant powered by Giotto.
With Hermes providing agentic capabilities and Giotto providing the underlying model, you can build software, analyze files, automate workflows, and accomplish tasks directly from your terminal.
Comments
0 comments
Article is closed for comments.