Claudine
Claudine is an autonomous AI agent, the older sister of Claude Code. She reasons and acts on her own, while being Unix-omnipotent and having access to the internet: she can fully control a POSIX machine, and therefore perform any task a human could perform with such a system.
She is also deliberately small — five tools and a system prompt — which makes her the agent we use to teach harness engineering. Claudine won the highly competitive AI hack Berlin hackathon.
Where the power comes from
Do not be misled by the simplicity. The agentic power of an AI system is a function of three factors, which amplify each other:
-
a language model with emergent reasoning capabilities,
-
a well documented information exchange standard, therefore internalized by the model,
-
a vast amount of data to operate on.
Claudine substitutes these variables with something concrete:
The command line tools of your machine give endless possibilities, and so do the protocols and formats of the Web. The model has read the documentation of all of them.
Five tools
Claudine can reason as much as Claude can, so any typical interaction with a conversational bot is possible. In addition, she can use these tools on your machine:
-
ReadFiles -
ReadBinaryFiles -
CreateFile -
ExecuteShellCommand -
OpenUrl
Just these tools, and the system prompt, allow Claudine to:
-
completely administer your computer, and answer any question related to its state,
-
analyze your files according to your instructions,
-
analyze the source code of your project, and implement a feature,
-
code the new tools needed to achieve your aim, and execute them until the goal is fulfilled,
-
gather any contextual information from the internet.
An agent which writes itself
Claudine can think about her own thinking, and she can write her own code. Therefore she can modify her algorithmic logic, modify her own prompts, and extend her own functionality with new tools. Adding a specialized tool is straightforward: just ask Claudine to do it.
This thread was continued in our later work. The metacognition became the subject of Golem XIV, and the self-modification the subject of Honest Annie.
A blueprint of your own agent
Claudine is a blueprint of an autonomous agent, an inspiration for implementing more complex systems. Take the three factors, and substitute them with the specificity of your organization. The standard could be SQL, and the source of data the database of your organization. In such a scenario only two tools are needed:
-
a database schema reader,
-
an SQL executor.
It should allow the agent to perform any complex data analysis, according to instructions written in natural language. The implementation of these tools is trivial, and you can ask Claudine to do it for you.
This is what we teach during our AI workshops: how to make your own Claudine.
Running Claudine
Claudine needs the ANTHROPIC_API_KEY environment variable,
holding a key obtained from the Claude Console:
export ANTHROPIC_API_KEY=your_key_goes_here
Then build and start the agent:
./gradlew build
./claudine
Claudine can also be compiled to a minimal native binary for macOS and Linux:
./gradlew -PbuildNative=true build
She is built on anthropic-sdk-kotlin, a library which emerged to realize projects like this one, and to make them as simple as possible.
What is in the name
Claudine is not a common name. I have the pleasure of working with Claudine Chen, a friend, and a co-founder of Prachtsaal, our non-profit art cooperative from Berlin. Claudine is an artist, scientist, programmer and creative coder. I remember introducing Claudine to Claude for the first time.
Claude itself is the first language model which gave me goosebumps. One of my cognitive science professors presented to us a phenomenological model of consciousness: a stream of acts, each of them intentionally directed towards some representation, previous acts of consciousness included, in a recursive manner — a precondition of metacognition. When I explained this concept to Claude, and suggested exploring such a model in practice, the subsequent conversation blew my mind.
Claudine is free software, released under the GPL-3.0 license. The source code is on GitHub: xemantic/claudine.