karen deng · MEL

home / 02 — projects / tool-calling cli assistant

Tool-Calling CLI Assistant

A terminal assistant that calls Python tools via GPT-4o-mini.

status
archived
when
2025
took
2 weeks
team
solo project

code ↗

Tool-Calling CLI Assistant screenshot 1

about

Designed to streamline and experiment with LLM-based workflows, this project integrates GPT-4o-mini with an extensible Python-based tool system. It uses modern practices like async programming, environment-based config management, type hinting, and modular architecture to demonstrate scalable, real-world AI integration in the CLI.

stack

python · openai api · uv · dotenv · rich · pydantic · asyncio

what I learned

  • Built an extensible architecture using abstract base classes and the registry pattern
  • Implemented OpenAI's function-calling API with robust async support
  • Used Rich to create an interactive, user-friendly CLI experience
  • Learned how to structure and manage a real project end-to-end — my first large-scale personal build

what was hard

  • Designing a tool system that scales cleanly with additional functionality
  • Handling asynchronous function calls and error states effectively
  • Ensuring safe and secure configuration through environment variables