[TASK] AI Agent Internal Hackathon Project Denbite

[thisisjoshford]

Background

As mentioned in #508, we are hosting an internal AI hackathon to test and provide feedback for NEAR AI in preparation for upcoming public hackathon events.

User Story

As a developer testing out a new AI platform, I expect a frictionless onboarding experience with accurate documentation and easy-to-follow steps. I expect the software to be up-to-date and work as expected.

Acceptance Criteria

• Think of an idea for creating a new AI agent
• Create AI agent and publish to app.near.ai
• Provide feedback from the development process in a google doc
• Submit any issues or useful feature requests in the near-ai repo
• Link completed work to this issue

Resources & Additional Notes

NEAR-AI Repo -> https://github.com/nearai/nearai
Docs -> https://docs.near.ai/
WIP Improvement Docs -> nearai/nearai#639
Example Agents -> https://app.near.ai/agents
Agent Ideas -> https://docs.google.com/document/d/1gWo5yXYaCIDVl0n0ptVRaCEindwzKDhbO7lj9x1b5og/edit?tab=t.0

Priority

🟠 P1 : High

[denbite]

Demo: https://chat.near.ai/agents/denbite.near/cooking-recipes/latest

The most painful part of the process was the installation of nearai CLI

• the documentation doesn't mention that Python 3.11 is the recommended version to go with, the newer versions (Python 3.13, in my case) fail to install packages required for the CLI
• as a person who hadn't worked with virtual environments before, it was a mess to set it up for the first time just to install the CL, because an attempt to do it without venv ends up with an error
  I'd love to see an installation option with a package manager like Brew

As for the development process, it was a smooth experience for me. Being able to test agents locally stands out, totally liked it
If you’re familiar with Python, I assume you’ll find the development experience intuitive in most aspects