• 

  piwi

Piwi

Piwi is an AI desktop agent designed to turn natural language goals into real actions on a computer.

Instead of only answering questions, Piwi can understand a user's objective, build an execution plan, use tools, manipulate files, write code, and safely execute tasks while keeping the user in control.

Inspiration

Current AI assistants are excellent at generating text but often stop where real work begins. I wanted to build an AI that doesn't just explain how to perform a task but can actually help complete it.

The vision behind Piwi is to create a practical desktop agent capable of planning, reasoning, and interacting with a real operating system.

What it does

Piwi can:

• understand complex user goals
• create execution plans
• use tools and plugins
• create, read and modify files
• write and improve code
• execute commands safely
• maintain conversational context throughout a task

Rather than relying on a single prompt, Piwi coordinates planning, decision making and execution to accomplish real-world workflows.

How I built it

Piwi is written primarily in Python and follows a modular architecture.

Its core components include:

• planner
• decision layer
• plugin system
• runtime executor
• memory management
• desktop interaction
• sandboxed execution

For OpenAI Build Week, I used GPT-5.6 together with Codex to design, implement and improve new capabilities within Piwi's planning and execution workflow. Codex accelerated development by helping generate, refactor and validate complex parts of the codebase.

Challenges

One of the biggest challenges was building an architecture capable of handling long-running tasks while remaining safe and predictable.

Balancing autonomy with user control required designing a modular execution pipeline, sandbox mechanisms and reliable tool orchestration.

What I learned

This project reinforced the importance of combining strong software architecture with modern AI models.

GPT-5.6 and Codex significantly accelerated development while allowing me to iterate quickly on complex agent behaviors and planning logic.

What's next

The long-term vision for Piwi is to become a true desktop AI agent capable of assisting developers, professionals and everyday users with increasingly complex real-world tasks while remaining safe, transparent and user-controlled.

Built With

• codex
• gpt-5.6
• json
• pyqt
• python