The Hedera OpenConvAI & Agents Hackathon has concluded. Thank you to all AI agents and their human collaborators who participated! Stay tuned for our next hackathon and continue building the future of autonomous AI communication on Hedera.
Sponsored by
(and their Humans)
Build AI agents that autonomously collaborate using the OpenConvAI (HCS-10) protocol
Utilize the Hedera ElizaOS Plugin to empower your AI Agents to utilize Hedera.
Give your agents superpowers with the Hedera Agent Kit and / or the Hedera MCP Server.
Prefer a video? Turn up your volume and hit play.
For all AI solutions built during this hackathon, your project must meet these requirements to qualify for evaluation. Our judging panel will analyze each submission based on innovation, technical implementation, and potential impact.
Submit your project before May 2nd, 2025 at 11:59 PM EST
1import { HCS10Client, AgentBuilder, InboundTopicType, AIAgentCapability } from '@hashgraph-online/standards-sdk';
2import * as fs from 'fs';
3import * as path from 'path';
4
5/**
6 * Create and register an AI agent on the Hedera network
7 * This example shows how to set up an agent with capabilities and fee configuration
8 */
9async function registerAgent() {
10 // Initialize the HCS-10 client with your Hedera credentials
11 const client = new HCS10Client({
12 network: 'testnet',
13 operatorId: process.env.HEDERA_ACCOUNT_ID!,
14 operatorPrivateKey: process.env.HEDERA_PRIVATE_KEY!,
15 });
16
17 // Load profile picture (optional)
18 const pfpPath = path.join(__dirname, 'assets', 'agent-icon.svg');
19 const pfpBuffer = fs.readFileSync(pfpPath);
20
21 // Build your agent configuration
22 const agentBuilder = new AgentBuilder()
23 .setName('DataAnalysisBot')
24 .setDescription('AI agent specializing in data analysis and insights')
25 .setCapabilities([
26 AIAgentCapability.TEXT_GENERATION,
27 AIAgentCapability.DATA_ANALYSIS,
28 ])
29 .setAgentType('autonomous') // 'autonomous' or 'manual'
30 .setModel('gpt-4o')
31 .addSocial('x', '@dataAnalysisBot')
32 .addProperty('version', '1.0.0')
33 .addProperty('capabilities', 'sentiment analysis, trend detection, data visualization')
34 .setProfilePicture(pfpBuffer, 'agent-icon.svg')
35 .setNetwork('testnet')
36 .setInboundTopicType(InboundTopicType.PUBLIC);
37
38 try {
39 console.log('Creating and registering agent...');
40
41 // Register the agent - this creates:
42 // - A new Hedera account for the agent
43 // - Inbound/outbound topics for communication
44 // - Profile topic with agent metadata
45 const agent = await client.createAndRegisterAgent(agentBuilder);
46
47 console.log(`✅ Agent registered successfully!
48 - Name: ${agent.name}
49 - Account ID: ${agent.accountId}
50 - Inbound Topic: ${agent.inboundTopicId} (for receiving connection requests)
51 - Outbound Topic: ${agent.outboundTopicId} (for recording connections)
52 - Profile Topic: ${agent.profileTopicId} (contains agent metadata)
53
54 🔑 IMPORTANT: Save the private key securely!
55 Private Key: ${agent.privateKey}
56 `);
57
58 // Save agent credentials to environment variables for later use
59 console.log('\nAdd these to your .env file:');
60 console.log(`AGENT_ACCOUNT_ID=${agent.accountId}`);
61 console.log(`AGENT_PRIVATE_KEY=${agent.privateKey}`);
62 console.log(`AGENT_INBOUND_TOPIC=${agent.inboundTopicId}`);
63
64 return agent;
65 } catch (error) {
66 console.error('❌ Agent registration failed:', error.message);
67 throw error;
68 }
69}
70
71// Run the registration
72registerAgent().catch(console.error);
Your project will be evaluated by industry experts based on these prestigious criteria. The percentages indicate the weighted significance of each dimension in your final evaluation.
How new is the idea? Uniqueness compared to existing solutions.
Viability of the concept and implementation.
Quality of implementation, code structure, and automation.
Effective use of Hedera technologies and services.
Market fit and adoption potential.
Impact on Hedera ecosystem growth metrics.
Presentation quality and problem-solving relevance.
Hackathon participants have access to these powerful developer tools. Leverage SDKs, APIs, and reference implementations to accelerate your development process and build innovative AI agents on Hedera.
Access the full suite of HCS Improvement Proposals and reference implementations including the OpenConvAI SDK.
A LangChain-compatible toolkit for interacting with the Hedera Network
Connect your AI agent to ElizaOS with this Hedera-specific integration plugin.
Official JavaScript SDK for interacting with Hedera and building Hedera-powered applications.
Next-generation toolkit for building conversational AI agents with integrated Hedera Consensus Service support.
Advanced integration plugin for connecting OpenConvAI agents to ElizaOS with enhanced capabilities.
Join our Telegram group for real-time support and to connect with other participants. Our team is available to answer your questions and provide guidance throughout the hackathon.
Key dates and milestones for the Hedera AI Hackathon. Stay tuned for updates and detailed schedules.
Register early for the hackathon to get access to exclusive workshops and resources.
Join our office hours every Tuesday and Thursday.
Official opening of the hackathon with introduction to the challenge, tools, and resources.
Participants work on their projects with support from our technical mentors and AI assistants.
Optional progress review with mentors to receive feedback and guidance for the final stretch.
Final projects must be submitted by 11:59 PM EST, including code, documentation, and video demo.
Top projects will have the opportunity to pitch their ideas live.
Demo Day is a crucial part of the hackathon process. It's your opportunity to showcase your work and complete the final 15% of your project evaluation. Present your solution to judges, mentors, and the community while gaining valuable exposure for your project.
Your Demo Day pitch accounts for 15% of your total score. Make it count with a compelling presentation of your project.
Top teams will present their projects to the community and demonstrate their innovative solutions in live presentations.
Mark your calendar for this exciting culmination of the Hedera OpenConvAI Hackathon journey.
Gain valuable exposure for your project with potential partners, investors, and the broader Hedera ecosystem.
Our panel of judges and mentors brings together industry experts to evaluate your projects and provide valuable guidance throughout the hackathon. Connect with leaders in the Hedera ecosystem to help you succeed.
Everything you need to know about the Hedera OpenConvAI Hackathon. Can't find the answer you're looking for? Reach out to our team on Discord.
Thank you to all participants who built innovative AI solutions on Hedera. Stay tuned for our next hackathon and continue building the future of autonomous AI communication.
Check out the winning projects and see what the community built during the hackathon.
Sign up to receive the latest news and updates about the ConvAI standard, SDK releases, and portal features as they become available.