Skip to content

nosana-ci/agent-challenge

Repository files navigation

Builders' Challenge #3: AI Agents 102

Presented by Nosana and Mastra

Agent

Welcome to the AI Agent Challenge

Build and deploy intelligent AI agents using the Mastra framework on the Nosana decentralized compute network. Whether you're a beginner or an experienced developer, this challenge has something for everyone!

🎯 Challenge Overview

Your Mission: Build an intelligent AI agent with a frontend interface and deploy it on Nosana's decentralized network.

What You'll Build

Create an AI agent that performs real-world tasks using:

  • Mastra framework for agent orchestration
  • Tool calling to interact with external services
  • MCP (Model Context Protocol) for enhanced capabilities
  • Custom frontend to showcase your agent's functionality

Agent Ideas & Examples

The possibilities are endless! Here are some ideas to get you started:

  • πŸ€– Personal Assistant - Schedule management, email drafting, task automation
  • πŸ“Š Data Analyst Agent - Fetch financial data, generate insights, create visualizations
  • 🌐 Web Researcher - Aggregate information from multiple sources, summarize findings
  • πŸ› οΈ DevOps Helper - Monitor services, automate deployments, manage infrastructure
  • 🎨 Content Creator - Generate social media posts, blog outlines, marketing copy
  • πŸ” Smart Search - Multi-source search with AI-powered result synthesis
  • πŸ’¬ Customer Support Bot - Answer FAQs, ticket routing, knowledge base queries

Be Creative! The best agents solve real problems in innovative ways.

Getting Started Template

This is a starter template for building AI agents using Mastra and CopilotKit. It provides a modern Next.js application with integrated AI capabilities and a beautiful UI.

Getting Started

Prerequisites & Registration

To participate in the challenge and get Nosana credits/NOS tokens, complete these steps:

  1. Register at SuperTeam
  2. Register at the Luma Page
  3. Star these repos:
  4. Complete this registration form

Setup Your Development Environment

Step 1: Fork, Clone and Quickstart

# Fork this repo on GitHub, then clone your fork
git clone https://github.com/YOUR-USERNAME/agent-challenge

cd agent-challenge

cp .env.example .env

pnpm i

pnpm run dev:ui      # Start UI server (port 3000)
pnpm run dev:agent   # Start Mastra agent server (port 4111)

Open http://localhost:3000 to see your agent in action in the frontend. Open http://localhost:4111 to open up the Mastra Agent Playground.

Step 2: Choose Your LLM for Development (Optional)

Pick one option below to power your agent during development:

Option A: Use Shared Nosana LLM Endpoint (Recommended - No Setup!)

We provide a free LLM endpoint hosted on Nosana for development. Edit your .env:

# Qwen3:8b - Nosana Endpoint
# Note baseURL for Ollama needs to be appended with `/api`
OLLAMA_API_URL=https://3yt39qx97wc9hqwwmylrphi4jsxrngjzxnjakkybnxbw.node.k8s.prd.nos.ci/api
MODEL_NAME_AT_ENDPOINT=qwen3:8b

If it goes down, reach out on Discord

Option B: Use Local LLM

Run Ollama locally (requires Ollama installed):

ollama pull qwen3:0.6b
ollama serve

Edit your .env:

OLLAMA_API_URL=http://127.0.0.1:11434/api
MODEL_NAME_AT_ENDPOINT=qwen3:0.6b
Option C: Use OpenAI

Add to your .env and uncomment the OpenAI line in src/mastra/agents/index.ts:

OPENAI_API_KEY=your-key-here

πŸ—οΈ Implementation Timeline

Important Dates:

  • Start Challenge: 10 October
  • Submission Deadline: 31 October
  • Winners Announced: 07 November

Phase 1: Development

  1. Setup : Fork repo, install dependencies, choose template
  2. Build : Implement your tool functions and agent logic
  3. Test : Validate functionality at http://localhost:3000

Phase 2: Containerization

  1. Clean up: Remove unused agents from src/mastra/index.ts
  2. Build: Create Docker container using the provided Dockerfile
  3. Test locally: Verify container works correctly
# Build your container (using the provided Dockerfile)
docker build -t yourusername/agent-challenge:latest .

# Test locally first
docker run -p 3000:3000 yourusername/agent-challenge:latest 

# Push to Docker Hub
docker login
docker push yourusername/agent-challenge:latest

Phase 3: Deployment to Nosana

  1. Deploy your complete stack: The provided Dockerfile will deploy:
    • Your Mastra agent
    • Your frontend interface
    • An LLM to power your agent (all in one container!)
  2. Verify: Test your deployed agent on Nosana network
  3. Capture proof: Screenshot or get deployment URL for submission

Phase 4: Video Demo

Record a 1-3 minute video demonstrating:

  • Your agent running on Nosana (show the deployed version!)
  • Key features and functionality
  • The frontend interface in action
  • Real-world use case demonstration
  • Upload to YouTube, Loom, or similar platform

Phase 5: Documentation

Update this README with:

  • Agent description and purpose
  • What tools/APIs your agent uses
  • Setup instructions
  • Environment variables required
  • Example usage and screenshots

βœ… Minimum Requirements

Your submission must include:

  • Agent with Tool Calling - At least one custom tool/function
  • Frontend Interface - Working UI to interact with your agent
  • Deployed on Nosana - Complete stack running on Nosana network
  • Docker Container - Published to Docker Hub
  • Video Demo - 1-3 minute demonstration
  • Updated README - Clear documentation in your forked repo
  • Social Media Post - Share on X/BlueSky/LinkedIn with #NosanaAgentChallenge

Submission Process

  1. Complete all requirements listed above
  2. Commit all of your changes to the main branch of your forked repository
    • All your code changes
    • Updated README
    • Link to your Docker container
    • Link to your video demo
    • Nosana deployment proof
  3. Social Media Post (Required): Share your submission on X (Twitter), BlueSky, or LinkedIn
    • Tag @nosana_ai
    • Include a brief description of your agent
    • Add hashtag #NosanaAgentChallenge
  4. Finalize your submission on the SuperTeam page
    • Add your forked GitHub repository link
    • Add a link to your social media post
    • Submissions that do not meet all requirements will not be considered

πŸš€ Deploying to Nosana

Using Nosana Dashboard

  1. Open Nosana Dashboard
  2. Click Expand to open the job definition editor
  3. Edit nos_job_def/nosana_mastra.json with your Docker image:
    {
      "image": "yourusername/agent-challenge:latest"
    }
  4. Copy and paste the edited job definition
  5. Select a GPU
  6. Click Deploy

Using Nosana CLI (Alternative)

npm install -g @nosana/cli
nosana job post --file ./nos_job_def/nosana_mastra.json --market nvidia-3090 --timeout 30

πŸ† Judging Criteria

Submissions evaluated on 4 key areas (25% each):

1. Innovation 🎨

  • Originality of agent concept
  • Creative use of AI capabilities
  • Unique problem-solving approach

2. Technical Implementation πŸ’»

  • Code quality and organization
  • Proper use of Mastra framework
  • Efficient tool implementation
  • Error handling and robustness

3. Nosana Integration ⚑

  • Successful deployment on Nosana
  • Resource efficiency
  • Stability and performance
  • Proper containerization

4. Real-World Impact 🌍

  • Practical use cases
  • Potential for adoption
  • Clear value proposition
  • Demonstration quality

🎁 Prizes

Top 10 submissions will be rewarded:

  • πŸ₯‡ 1st Place: $1,000 USDC
  • πŸ₯ˆ 2nd Place: $750 USDC
  • πŸ₯‰ 3rd Place: $450 USDC
  • πŸ… 4th Place: $200 USDC
  • πŸ… 5th-10th Place: $100 USDC each

πŸ“š Learning Resources

For more information, check out the following resources:

πŸ†˜ Support & Community

Get Help

πŸŽ‰ Ready to Build?

  1. Fork this repository
  2. Build your AI agent
  3. Deploy to Nosana
  4. Present your creation

Good luck, builders! We can't wait to see the innovative AI agents you create for the Nosana ecosystem.

Happy Building! πŸš€

Stay in the Loop

Want access to exclusive builder perks, early challenges, and Nosana credits? Subscribe to our newsletter and never miss an update.

πŸ‘‰ Join the Nosana Builders Newsletter

Be the first to know about:

  • 🧠 Upcoming Builders Challenges
  • πŸ’Έ New reward opportunities
  • βš™ Product updates and feature drops
  • 🎁 Early-bird credits and partner perks

Join the Nosana builder community today β€” and build the future of decentralized AI.

About

Nosana Builders' Challenge: Agent 101

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published