YiemAgent/README.md

YiemAgent

Julia framework for building agents with tool use.

Getting Started

1. Install dependencies: ]add JSON, DataStructures, UUIDs, Dates, ...
2. Create a yiemAgent with loadTools("src/tools")
3. Call runAgent(agent, "message") then takeResponse(agent)

Architecture

src/
├── YiemAgent.jl          # Module entry point
├── type.jl               # Core types (messages, tools, agent state)
├── utils.jl              # Message formatting, validation
├── agentCore.jl          # Agent loop, tool execution pipeline
├── api.jl                # Public API (runAgent, takeResponse, etc.)
└── tools/
    ├── registry.jl       # Tool registry (loadTools, registerTool, listTools)
    ├── getWeather.jl     # Weather lookup tool
    ├── getTime.jl        # Time lookup tool
    ├── writeTool.jl      # Create new tool files (self-modifying)
    └── README.md         # Tool development guide

Tool Development

See src/tools/README.md for:

• Tool anatomy (schema, execute, getTool)
• Validation hooks
• Agent loop lifecycle
• Self-modifying tools (writeTool)