Project Info
Inspiration
We realized how often people struggle with gifting — not because they lack affection, but because they lack understanding of what would genuinely delight someone. Remembering birthdays, choosing meaningful gifts, and keeping surprises intact can become overwhelming. That’s what inspired Agent Santa — an autonomous gifting ecosystem where agents know you, understand you, and gift like you would. Our idea began with a simple thought: “What if your AI could talk to your friend’s AI and decide the perfect gift — all by itself?” This curiosity led us into the world of multi-agent systems, Fetch.ai’s Agentverse, and ASI.one, where we turned that thought into a working system.
What it does
Agent Santa consists of four main components: Personality Agents – autonomous representations of each user, powered by Grok-LLaMA. These agents store our interests, preferences, and traits, and can communicate with each other. Agent Santa (Gifting Agent) – the core orchestrator deployed on Agentverse. It queries personality agents, understands who the recipient is, and suggests personalized gifts. Shopping & Comparison Engine – built into the gifting agent to evaluate multiple options, compare prices, and pick the best choice. Payment Layer – simulates secure transactions to complete the gifting process end-to-end. A typical interaction looks like this: User Request on ASI.one→Agent Santa→Recipient Personality Agent→Gift Suggestion + Payment
How we built it
Framework: uAgents on Fetch.ai Deployment: Fully on Agentverse with seamless integration via ASI.one LLM Backbone: Grok-LLaMA, for reasoning and contextual understanding Architecture: Event-driven, asynchronous message passing between agents using defined protocols Workflow: User prompts on ASI.one →Agent Santa identified as best gifting agent →Queries personality agent for metadata →Runs LLaMA reasoning for suggestions →Compares, finalizes, and simulates secure checkout.
Challenges we ran into
-Establishing cross-communication between ASI.one personality agents and Agentverse-hosted agents. -Overcoming protocol mismatches (chat protocol vs. custom message protocol). -Managing offline agent availability and mailbox configurations. -Designing an end-to-end pipeline that includes reasoning, recommendation, and simulated payment within Fetch.ai’s decentralized ecosystem. -Coordinating multiple LLaMA-powered agents while keeping the interaction smooth and contextually consistent.
Accomplishments we're proud of
End-to-End Autonomous Gifting Flow We successfully built a fully functional multi-agent ecosystem where a user can simply say, “Gift something to Devam for his birthday,” and the agents handle the entire pipeline — from understanding the relationship → fetching personality data → reasoning gift ideas → comparing products → to completing payment — entirely autonomously. This demonstrates the real-world viability of autonomous AI-to-AI collaboration on Fetch.ai’s Agentverse. Cross-Agent Personality Collaboration Each of our Personality Agents can interact, exchange metadata, and understand other users’ preferences — making every gifting decision deeply personalized and socially aware. This was a breakthrough moment: realizing our agents could “know” each other, form friendships, and build trust networks — a microcosm of human-like social intelligence in an AI ecosystem. LLaMA-Powered Reasoning Layer Integrating Grok-LLaMA into every agent gave them contextual intelligence — letting them reason about personality traits, occasions, and sentiment before recommending gifts. The result: contextual empathy — an AI that doesn’t just recommend, but understands why. Seamless Integration of ASI.one and Agentverse We bridged two ecosystems — ASI.one and Agentverse — allowing users to interact naturally through ASI.one, while all autonomous logic ran on Agentverse. This fusion of human-facing interface and agent-facing intelligence is one of the first demonstrations of its kind. End-to-End Payment Simulation Our gifting agent doesn’t stop at recommendations — it carries out the final payment step securely. This creates a truly closed-loop automation pipeline, showcasing how Fetch.ai agents can complete complex, multi-step tasks without human intervention. Vision Expansion Beyond Gifting During development, we discovered that Personality Agents could go beyond gifting — acting as AI versions of us that can represent us online, interact with recruiters, and communicate our personalities authentically. That realization expanded our project’s purpose — from gifting to digital identity representation — a concept we’re incredibly proud to pioneer. Ranked Among Top Agents on ASI.one Our SantaAI agent achieved top ranking in the gifting category on ASI.one, validating both the performance and relevance of our idea in Fetch.ai’s growing ecosystem.
What we learned
-The power of decentralized AI agents — how independent entities can collaborate without central control. -The importance of protocol design for reliable agent-to-agent communication. -LLM integration in reasoning workflows for context-aware decision making. -The subtle but crucial difference between social collaboration on ASI.one and runtime reachability on Agentverse. -How autonomous systems can move beyond automation into human-level social intelligence.
What's next
Agent Santa started as a gifting agent — but it opened a doorway to something much bigger: A future where personality-driven agents represent humans authentically — helping others know, connect, and interact with us without barriers. From surprise gifting to AI-based networking and identity representation, Agent Santa marks a step toward the next generation of socially intelligent AI ecosystems.
🎁 Santa Agent - The Ultimate Gift Recommendation System
Agent Santa uses AI agents to find perfect gifts by asking your friends' personal AI what they actually want.
Santa Agent revolutionizes gift-giving by connecting with your friends' personal AI agents to understand their true preferences, then finding real Amazon products that match perfectly. No more guessing games or generic gifts - just thoughtful, personalized recommendations every time.
🌟 What Makes Santa Agent Special?
🤖 Revolutionary Agent-to-Agent Communication
Santa Agent doesn't just guess what someone might like - it actually asks their personal AI agent! When you want to buy a gift for a friend, Santa Agent connects directly with their AI agent to learn about their personality, interests, and preferences in real-time.
🎯 Perfect Gift Discovery
- Real-time preference learning from your friends' AI agents
- Live Amazon product search with current prices and availability
- Personalized recommendations based on actual personality data
- Instant gift suggestions with direct purchase links
💡 The Value You Get
- Never buy the wrong gift again - AI agents know your friends better than you do
- Save hours of research - instant personalized recommendations
- Discover unique gifts - AI finds products you'd never think of
- Perfect for any occasion - birthdays, anniversaries, holidays, or just because
🚀 How It Works - The Magic Behind Santa Agent
Step 1: You Request a Gift
Simply type: "I want to buy a gift for Parth" or "Find a gift for my friend Devam"
Step 2: AI Agents Connect
Santa Agent automatically reaches out to your friend's personal AI agent and asks:
- "What's Parth's personality like?"
- "What kind of gifts would Parth enjoy?"
Step 3: Real-Time Learning
Your friend's AI agent responds with detailed insights about their personality and gift preferences.
Step 4: Smart Gift Search
Santa Agent uses this information to search Amazon for products that perfectly match your friend's interests and personality.
Step 5: Perfect Recommendations
You receive a curated list of real Amazon products with prices, descriptions, and direct purchase links.
🎯 Real Examples - See Santa Agent in Action
Example 1: Birthday Gift for Your Adventurous Friend
You: "I need a gift for Parth's birthday"
Santa Agent: "🎁 Getting gift recommendations for Parth..."
[Connects to Parth's AI agent]
Parth's AI: "Parth loves outdoor sports, adventure gear, and fitness equipment.
He enjoys high-energy activities and competitive environments."
Santa Agent: "🎁 Gift Recommendations for Parth
Based on preferences: Outdoor sports, adventure gear, fitness equipment...
Recommended Gifts:
1. GoPro HERO12 Action Camera - $399.99
Professional 4K video recording for adventures
[View on Amazon](https://amazon.com/...)
2. Garmin Fenix 7 GPS Smartwatch - $699.99
Advanced fitness tracking for outdoor activities
[View on Amazon](https://amazon.com/...)
3. Patagonia Hiking Backpack - $149.99
Durable gear for outdoor adventures
[View on Amazon](https://amazon.com/...)"
Example 2: Anniversary Gift for Your Creative Partner
You: "Find something special for Sakshi's anniversary"
Santa Agent: "🎁 Getting gift recommendations for Sakshi..."
[Connects to Sakshi's AI agent]
Sakshi's AI: "Sakshi is artistic, loves handmade crafts, and enjoys
creative tools. She values unique, thoughtful gifts."
Santa Agent: "🎁 Gift Recommendations for Sakshi
Based on preferences: Artistic, handmade crafts, creative tools...
Recommended Gifts:
1. Professional Art Supply Set - $89.99
High-quality paints, brushes, and canvases
[View on Amazon](https://amazon.com/...)
2. Handmade Ceramic Vase - $45.99
Unique artisan-crafted home decor
[View on Amazon](https://amazon.com/...)
3. Creative Writing Journal Set - $29.99
Beautiful notebooks for artistic expression
[View on Amazon](https://amazon.com/...)"
🔥 Why Agent-to-Agent Communication Changes Everything
Traditional Gift Shopping Problems:
- ❌ Guessing games - You don't really know what they want
- ❌ Generic gifts - Same old boring presents
- ❌ Wasted money - Buying things they'll never use
- ❌ Time consuming - Hours of research for mediocre results
Santa Agent's Agent-to-Agent Solution:
- ✅ Direct insight - Their AI agent knows them better than anyone
- ✅ Personalized discovery - Gifts that match their true personality
- ✅ Smart spending - Every purchase is a perfect match
- ✅ Instant results - Get recommendations in seconds, not hours
🎁 Perfect for Every Occasion
Birthday Gifts
- Personalized recommendations based on their AI agent's personality insights
- Age-appropriate and interest-specific gift suggestions
- Budget-friendly options from $20 to $500+
Anniversary Presents
- Romantic and thoughtful gifts that show you really know them
- Unique items that reflect their personal interests
- Special occasion upgrades and luxury options
Holiday Shopping
- Christmas, Hanukkah, and other holiday gift ideas
- Bulk gift recommendations for multiple friends
- Seasonal and themed present suggestions
Just Because Gifts
- Surprise your friends with unexpected thoughtful presents
- Random acts of kindness with perfectly chosen gifts
- Celebration gifts for achievements and milestones
🚀 Getting Started - It's Incredibly Easy
1. Start Shopping
Simply type: "gift [friend's name]" and watch the magic happen!
2. Get Perfect Recommendations
Receive personalized gift suggestions with real Amazon products, prices, and purchase links.
🔍 SEO Keywords & Search Optimization
Primary Keywords:
- gift recommendation system
- AI gift finder
- personalized gift suggestions
- smart gift shopping
- automated gift discovery
- AI-powered gift recommendations
- intelligent gift matching
- personalized present finder
Long-tail Keywords:
- "find perfect gift for friend"
- "AI gift recommendation engine"
- "personalized birthday gift ideas"
- "smart gift shopping assistant"
- "automated gift discovery tool"
- "AI-powered present finder"
- "intelligent gift matching system"
- "personalized anniversary gifts"
Use Cases & Intent Keywords:
- "looking for gifts online"
- "need gift ideas for boyfriend"
- "best gifts for girlfriend"
- "unique gift recommendations"
- "thoughtful present ideas"
- "gift shopping made easy"
- "AI gift assistant"
- "smart gift finder"
🌟 The Future of Gift-Giving
Santa Agent represents the future of personalized shopping, where AI agents work together to create perfect gift experiences. No more generic presents or wasted money - just thoughtful, personalized gifts that show you truly care.
Ready to revolutionize your gift-giving? Start using Santa Agent today and never buy the wrong gift again!
Built with ❤️ for CalHacks 2025 - Where AI meets human connection
Transform every gift into a perfect moment of joy and connection.
Analysis
View
Metric
- 16
- 6
- 4
Figures cover GitHub contributors during the hackathon window. A co-authored commit counts in full for each author, so per-member totals add up to more than the whole-team figures.
Technology
- FastAPIIn code
- HTMLIn code
- PythonIn code
- VercelClaimed
3 of 4 appear in the indexed code. 1 claimed on Devpost could not be matched to code, which may simply mean the tool leaves no trace in the repository.
AI coding agents
No AI coding agent signals were found in this repository.
Detected from committed agent config files and commit authorship. Absence of a signal is not proof an agent was unused.
Codebase size
Source size
247 KB
Source files
31
Counts recognized source files only; vendored directories, binaries and lockfiles are excluded, so this is smaller than the repository on disk.
Repository
ParthPatel00/SantAI
39 files · 260 KB · @ 9edea44
Structure
Interface
2 files · 5%Screens, components and styles rendered to the user.
Application logic
22 files · 56%Domain rules, services and shared utilities.
Supporting
Layers are inferred from where files sit in the tree, not from reading the code. A project that names its directories unconventionally will read oddly here — open the file browser to check anything the diagram implies.
Languages
- Python77%
- Markdown14%
- HTML9%
Share of indexed source by file size. Binary and vendored files are excluded.
Dependencies
requirements.txt
pypi · 60- aiohappyeyeballs
- aiohttp
- aiosignal
- annotated-doc
- annotated-types
- anyio
- attrs
- bcrypt
- bech32
- certifi
- cffi
- charset-normalizer
- click
- colorama
- cosmpy
- cryptography
- distlib
- distro
- +42 more
Gift-expert/requirements.txt
pypi · 56- aiohappyeyeballs
- aiohttp
- aiosignal
- annotated-doc
- annotated-types
- anyio
- attrs
- bcrypt
- bech32
- certifi
- cffi
- charset-normalizer
- click
- colorama
- cosmpy
- distlib
- distro
- ecdsa
- +38 more
personality-agents/requirements.txt
pypi · 4- groq
- python-dotenv
- uagents
- uagents-core
Declared in the repository’s manifests at the indexed commit. A declared package is not proof it is used, and runtime dependencies are listed first.
Feature verification
Agent Santa (Gifting Agent) orchestrator queries personality agents and suggests giftsVerified
Agent Santa is the core orchestrator deployed on Agentverse; queries personality agents, understands recipient, suggests gifts
Claimed on Devposthigh confidenceGift-expert/agent.py:21— uAgents Agent with mailbox=True, chat protocol included and manifest published (Agentverse deployment pattern)Gift-expert/conversation_flow.py:60— process_user_input routes recipient name mentions to friend_interface to query the recipient's personality agent
Agent-to-agent communication (personality agents talk to each other / gifting agent)Verified
Personality agents can communicate with each other and with the gifting agent
Claimed on Devposthigh confidenceGift-expert/friend_interface.py:30— communicate_with_friend sends ChatMessage to a friend's agent address and awaits response via uAgent chat protocolGift-expert/agent.py:47— handle_message routes incoming messages from friend agent addresses to friend_interface.handle_friend_response
Built on Fetch.ai uAgents framework, deployed on AgentverseVerified
Framework: uAgents on Fetch.ai; Deployment: Fully on Agentverse
Claimed on Devposthigh confidenceGift-expert/agent.py:1— Imports and uses uagents.Agent/Context/Protocol and publishes chat protocol manifest, the Agentverse integration mechanism
Live Amazon product search with real prices/linksVerified
Live Amazon product search with current prices and availability, direct purchase links
Claimed on readmehigh confidenceGift-expert/shopping_agent_interface.py:178— _search_amazon_products calls the OpenWeb Ninja Amazon Data API and parses product title/price/url/rating into GiftItem objects
Natural language request handling ("gift [friend's name]")Verified
User types 'gift for Parth' style requests and the system handles the flow
Claimed on readmemedium confidenceGift-expert/conversation_flow.py:57— process_user_input scans user_input for known friend names (devam, parth, sakshi) and routes to friend_interface accordingly
Payment Layer simulates secure end-to-end transactionsVerified
Payment Layer simulates secure transactions to complete the gifting process end-to-end
Claimed on Devposthigh confidencepayment_service.py:93— process_payment simulates a transaction and returns a fake transaction_id, explicitly a simulation (not real payment processing)Gift-expert/conversation_flow.py:532— Gift recommendation flow generates a payment_url via payment_service.create_payment_link and surfaces it as a 'Buy Now' linkpayment_server.py:144— FastAPI endpoint /process-payment/{payment_id} completes the checkout flow with a mock Stripe-style page
Personality agents represent users with distinct traitsVerified
Personality Agents are autonomous representations of each user, storing interests, preferences, and traits
Claimed on Devposthigh confidencepersonality-agents/agent_parth.py:45— AGENT_CONTEXT hardcodes Parth's personality traits used to generate LLM responses as a distinct uAgent
Real-time preference learning from friend's AI agent via chatVerified
Santa Agent asks the friend's personal AI agent about personality and gift preferences in real time
Claimed on readmehigh confidenceGift-expert/friend_interface.py:104— _ask_about_personality and _ask_about_gift_preferences send targeted questions to the friend's agent and poll for a response with a timeout
ASI.one integration for user-facing interactionCode-supported
Seamless integration via ASI.one; users interact naturally through ASI.one
Claimed on Devpostlow confidencedeploy_asi_one.py:1— Deployment/test script references ASI.one dashboard and describes publishing the agent there, but ASI.one-side registration/ranking cannot be verified from this repo
Personality agents powered by LLaMA/Groq reasoningCode-supported
Personality Agents powered by Grok-LLaMA reason about traits and context
Claimed on Devpostmedium confidencepersonality-agents/agent_parth.py:120— Uses Groq client with llama-3.1-8b-instant model, not 'Grok' (xAI); claim of Grok-LLaMA appears to conflate Groq (inference provider) with Grok (xAI model), but LLaMA reasoning via Groq is real
Shopping & Comparison Engine evaluates and compares gift optionsCode-supported
Shopping & Comparison Engine evaluates multiple options, compares prices, and picks the best choice
Claimed on Devpostmedium confidenceGift-expert/shopping_agent_interface.py:64— call_shopping_agent searches Amazon products via OpenWeb Ninja API and returns a list of GiftItem candidatesGift-expert/llm_service.py:431— generate_gift_recommendations uses LLM to rank/select top 5 gifts from candidates based on preferences, called from conversation_flow.py
Built with VercelClaimed only
Built With: vercel
Claimed on Devpostmedium confidenceVision expansion: personality agents as digital identity / recruiter-facing representationClaimed only
Personality Agents could represent users online and interact with recruiters, expanding beyond gifting
Claimed on Devposthigh confidenceTop ranking on ASI.one gifting categoryBlocked
SantaAI agent achieved top ranking in the gifting category on ASI.one
Claimed on Devpostlow confidence
An AI agent derived these features from the project’s Devpost page and readme, then searched the code for each one. Verified features are backed by cited code; claimed-only features had no supporting code, which is not by itself proof a feature is missing.
Export this project's context (description, README, evidence, key source files) to chat with an AI agent elsewhere.