A minimal coding agent
harness in pure Python.

No framework, nothing crazy. Just readable Python you can follow from top to bottom. Nyvero is a starting point (V0.1.0) for your own coding agent, so take it apart and make it do what you need.

curl -fsSL https://nyvero-cli.vercel.app/install.sh | bash
~/projects/billing-api 

      

    

  


  
  

    

      
What it is

      
A starting point, not a finished product.

      
Nyvero is the smallest useful core of a coding agent. It's all plain Python, so read it, change it, and make it yours.

    


    

      

        
Pure Python, no framework

        
The whole thing runs on the standard library. There's no dependency tree to audit, nothing new to learn, and no build step in your way.

        

          runtime python 3.10+

          dependencies  standard library only
        

      


      

        
Small enough to read

        
Plain functions, clear names, few files. The point is that you can follow the entire agent in one sitting.

      


      

        
Bring your own model

        
Point it at whatever model you like. Adding a provider is one small file.

      


      

        
The agent loop

        
It thinks, acts, and observes. Read a file, write a patch, run a command, then go again until the job is done.

      


      

        
Not production ready

        
This is early and rough around the edges. Treat it as a base to build on, not something to ship as is.

      


      

        
Built to be forked

        
Take the loop, the tools, or just the prompt handling and drop it into your own project. It's MIT licensed, and there's no plugin system to fight.

        
class Agent: """one loop, a few tools, no magic."""

      

    

  


  
  

    

      

        
How it works

        
Three moves, one session.

        
    
          
  1. 
            01
            
    
              
    Describe the change
    
              
    Open the repo you're working in and just say what you want, in plain English. It runs straight from the source, so there's nothing to set up.
    
            
    
          
    2. 
          
  2. 
            02
            
    
              
    Watch it work
    
              
    It reads files, calls tools, and runs commands, printing each step as it goes.
    
            
    
          
    3. 
          
  3. 
            03
            
    
              
    Approve the diff
    
              
    Look over the patch, edit it by hand if you want, or reject it and ask again. Then commit it yourself.
    
            
    
          
    4. 
        

      


      
    

  


  
  

    

      
Get started

      
Install it in one line.

      
The installer sets up uv, clones Nyvero, runs uv sync, and puts the nyvero command on your PATH.

    


    

      

        
linux / macosbash or zsh

        

          
          curl -fsSL https://nyvero-cli.vercel.app/install.sh | bash
          
        

      


      

        
windowsPowerShell

        

          
          irm https://nyvero-cli.vercel.app/install.ps1 | iex
          
        

      


      

        
readstart at the entry point

        

          
          cat README.md
          
        

      

    


    

      Rather grab it from the repo yourself? Clone https://github.com/NilLab-agi/Nyvero,
      run uv sync, then uv run nyvero. That is exactly what the installers do.
    


    

      Just so you know: this is an early base, not a finished tool. Expect rough edges, missing
      pieces, and breaking changes. That's kind of the point. Read it, fork it, and build the
      agent you want. Not sure where to start? There's a roadmap
      of ideas I never got to, all open for anyone to pick up.