Empower AI to Get Things Done for You

NPi (Natural-language Programming Interface), pronounced as "N π", is an open-source platform providing Tool-use APIs to empower AI agents with the ability to operate and interact with a diverse array of software tools and applications.


pip install npiai

One-Minute Quick Start

Let's create a new tool to compute the nth Fibonacci number. Start by crafting a new Python file titled main.py and insert the following snippet:

import os
import json
import asyncio
from openai import OpenAI
from npiai import FunctionTool, function
class MyTool(FunctionTool):
    def __init__(self):
            description='My first NPi tool',
    def fibonacci(self, n: int) -> int:
        Get the nth Fibonacci number.
            n: The index of the Fibonacci number in the sequence.
        if n == 0:
            return 0
        if n == 1:
            return 1
        return self.fibonacci(n - 1) + self.fibonacci(n - 2)
async def main():
    async with MyTool() as tool:
        print(f'The schema of the tool is\n\n {json.dumps(tool.tools, indent=2)}')
        client = OpenAI(api_key=os.getenv('OPENAI_API_KEY'))
        messages = [
                "role": "user",
                "content": "What's the 10-th fibonacci number?",
        response = client.chat.completions.create(
            tools=tool.tools,  # use My as functions package
        response_message = response.choices[0].message
        if response_message.tool_calls:
            result = await tool.call(tool_calls=response_message.tool_calls)
            print(f'The result of function\n\n {json.dumps(result, indent=2)}')
if __name__ == "__main__":

Now, run the tool:

python main.py

You will see the function result in OpenAI function calling format (opens in a new tab):

    "role": "tool",
    "name": "fibonacci",
    "tool_call_id": "call_4KItpriZmoGxXgDloI5WOtHm",
    "content": 55

content: 55 is the result of function calling, and the schema:

    "type": "function",
    "function": {
      "name": "fibonacci",
      "description": "Get the nth Fibonacci number.",
      "parameters": {
        "properties": {
          "n": {
            "description": "The index of the Fibonacci number in the sequence.",
            "type": "integer"
        "required": [
        "type": "object"

The high-lighted part is automatically parsed from code.

That's it! You've successfully created and run your first NPi tool. 🎉

Next Steps