Running Instructions

Clone the repo, create env file, you will need laminar tracing and open ai api key. npm install, npm run build. Type AGI on your cli to access and then fire away.

Some Important Details

🤖 An end-to-end AI agent built from scratch using the OpenAI SDK, capable of reasoning, using tools, and executing real-world tasks. This project focuses on building production-ready agents with strong evaluation, observability, and safety mechanisms

🚀 Features Agent Loop Architecture – Handles multi-step reasoning, tool usage, and dynamic decision-making Tool Calling – Integrates external tools like: File system (read, write, list, delete) Web search API calls Shell/command execution Multi-Turn Conversations – Maintains context and state across interactions Evaluation Pipelines Single-turn evals (tool selection, output accuracy) Multi-turn evals (end-to-end behavior & UX) Observability & Tracing – Integrated with Laminar for telemetry and debugging Context Management – Handles token limits with: Summarization Context window compaction Efficient message filtering Human-in-the-Loop – Approval system for safe execution of sensitive actions Sandboxed Execution – Secure environment for running commands and code

🛠️ Tech Stack JavaScript / TypeScript OpenAI SDK Zod (schema validation) Laminar (observability & eval tracing) Node.js runtime