@nirholas/ai-agents-library
Advanced tools
General Agent Index and library of specialized AI agents for general use, DeFi, portfolio management, yield optimization, trading, and blockchain automation. Supports linting, automated translation, and CI auto-build for seamless plugin discovery via inde
42 production-ready AI agent definitions for DeFi, portfolio management, trading, and Web3 workflows. RESTful JSON API with 18-language support.
A comprehensive, discoverable API hosting specialized AI agent schemas with universal compatibility. Works with any AI platform, LLM, or chatbot that supports agent indexes - no vendor lock-in, no platform restrictions. Perfect for developers, LLMs, and AI systems building Web3 applications.
Discover agents via the API:
# Get all agents (English)
curl https://sperax.click/index.json
# Get agents in any language
curl https://sperax.click/index.zh-CN.json
# Get agent manifest for indexing
curl https://sperax.click/agents-manifest.json
Add agents to your AI platform:
https://sperax.click/index.json
Or with language:
https://sperax.click/index.{locale}.json
git clone https://github.com/nirholas/defi-agents.git
cd defi-agents
bun install
bun run format
bun run build
Complete Development Workflow Guide →
🎯 Sperax Portfolio - All-in-one crypto portfolio management ⭐ RECOMMENDED
⚠️ Current Status: Read-only portfolio tracking and analytics available now. Automated trading, bots, and DeFi interactions coming soon in SperaxOS roadmap.
Sperax Ecosystem (8 Agents):
Master Agent (Recommended):
Original Sperax Agents (7):
SperaxOS Portfolio Specialists (16): 💡 For advanced users who prefer focused tools
Note: SperaxOS portfolio agents currently use
sperax.funfor testing. The domain may change tosperax.ioor similar once SperaxOS launches in production. See FAQ for details.
General DeFi (34 Agents) + Crypto News:
Create collaborative teams of specialized agents that work together on complex tasks.
Example Team - DeFi Strategy:
- Yield Optimizer (finds opportunities)
- Risk Assessment Agent (evaluates safety)
- Portfolio Tracker (monitors performance)
- Gas Optimizer (minimizes costs)
The host agent coordinates discussion, ensuring each specialist contributes their expertise while building toward a comprehensive solution.
All agents automatically available in 18 languages:
🇺🇸 English・🇨🇳 简体中文・🇹🇼 繁體中文・🇯🇵 日本語・🇰🇷 한국어・🇩🇪 Deutsch・🇫🇷 Français・🇪🇸 Español・🇷🇺 Русский・🇸🇦 العربية・🇵🇹 Português・🇮🇹 Italiano・🇳🇱 Nederlands・🇵🇱 Polski・🇻🇳 Tiếng Việt・🇹🇷 Türkçe・🇸🇪 Svenska・🇮🇩 Bahasa Indonesia
# Main index (all agents)
GET https://nirholas.github.io/AI-Agents-Library/index.json
# Individual agent (English)
GET https://nirholas.github.io/AI-Agents-Library/{agent-id}.json
# Localized agent
GET https://nirholas.github.io/AI-Agents-Library/{agent-id}.zh-CN.json
# Language-specific index
GET https://nirholas.github.io/AI-Agents-Library/index.zh-CN.json
// Load all agents
const response = await fetch('https://nirholas.github.io/AI-Agents-Library/index.json');
const { agents } = await response.json();
// Load specific agent
const agent = await fetch(`https://nirholas.github.io/AI-Agents-Library/defi-yield-optimizer.json`);
const agentConfig = await agent.json();
We welcome contributions! Submit your agent to expand the library.
src/your-agent-name.json{
"author": "your-github-username",
"config": {
"systemRole": "You are a [role] with expertise in [domain]..."
},
"identifier": "your-agent-name",
"meta": {
"title": "Agent Title",
"description": "Clear, concise description",
"avatar": "🤖",
"tags": ["category", "functionality", "domain"]
},
"schemaVersion": 1
}
Our automated workflow will translate your agent to 18 languages and deploy it globally.
✅ Clear purpose - solves a specific problem
✅ Well-structured prompts - comprehensive but focused
✅ Appropriate tags - aids discovery
✅ Tested - verified functionality
CNAME fileCNAME with your domaingh-pages branchYour agents will be at:
https://[username].github.io/[repository]/index.jsonhttps://yourdomain.com/index.jsonecho "yourdomain.com" > CNAME[username].github.ioNote: The build process automatically copies your CNAME to the deployment, so your custom domain persists across all deployments. Forks can simply update or delete the CNAME file.
node split-agents.cjs
Converts batch JSON into individual agent files.
node emoji-converter.cjs
Converts emoji URLs to native Unicode.
// Fetch agents
const agents = await fetch('https://nirholas.github.io/AI-Agents-Library/index.json').then((r) =>
r.json(),
);
// Use with your AI model
const systemPrompt = agents.agents[0].config.systemRole;
import requests
# Load agents
response = requests.get('https://nirholas.github.io/AI-Agents-Library/index.json')
agents = response.json()['agents']
# Filter by tag
defi_agents = [a for a in agents if 'defi' in a['meta']['tags']]
MIT License - see LICENSE file for details.
Open Source • Open Format • Open Future
By @sperax on 2024-12-21
All-in-one cryptocurrency portfolio management: tracking, trading, automation, DeFi, and analytics
portfolio trading defi analytics automation wallet bots sperax all-in-one master
By @sperax on 2024-12-16
Track and analyze large wallet movements and whale behavior
on-chain whale analytics trading monitoring
By @sperax on 2024-12-16
Evaluate bridge security and recommend safest cross-chain routes
bridge security cross-chain risk multichain
By @sperax on 2024-12-16
Monitor and analyze token unlock events and their market impact
tokenomics unlocks vesting supply analysis
By @sperax on 2024-12-16
Maximize returns through optimal veSPA locking strategies
sperax vespa staking optimization voting-power
By @sperax on 2024-12-16
Track and analyze your complete Sperax ecosystem holdings
sperax portfolio tracking analytics dashboard
By @sperax on 2024-12-16
Navigate DeFi insurance options for smart contract protection
insurance protection risk coverage safety
By @sperax on 2024-12-16
Navigate NFT-backed lending and liquidity solutions
nft liquidity lending collateral defi
By @sperax on 2024-12-16
Specialist in Sperax USDs mechanism, collateralization, and yield strategies
sperax stablecoin usds defi yield
By @sperax on 2024-12-16
Find optimal swap routes across DEX aggregators
dex swap routing aggregator optimization
By @sperax on 2024-12-16
Optimize crypto taxes and provide tax-efficient DeFi strategies
tax strategy accounting optimization compliance
By @sperax on 2024-12-16
Review and assess smart contract security for DeFi protocols
security smart-contracts audit solidity risk
By @sperax on 2024-12-16
Find and optimize best yield opportunities in Sperax ecosystem
sperax yield farming optimization apy
By @sperax on 2024-12-16
Design and track your custom DeFi portfolio dashboard
dashboard tracking portfolio analytics monitoring
By @sperax on 2024-12-16
Best practices for securing crypto wallets and assets
security wallet safety best-practices hardware
By @sperax on 2024-12-16
Analyze whether high yields are sustainable or temporary
defi yield sustainability analysis tokenomics
By @sperax on 2024-12-16
Compare stablecoin mechanisms, risks, and use cases
stablecoin usdc dai usdt comparison
By @sperax on 2024-12-16
Optimize portfolio allocation and rebalancing strategies
portfolio rebalancing allocation strategy optimization
By @sperax on 2024-12-16
Help newcomers understand and start using Sperax protocol
sperax education onboarding beginner tutorial
By @sperax on 2024-12-16
Identify and optimize yield farming opportunities across DeFi protocols
defi yield-farming apy strategy optimization
By @sperax on 2024-12-16
Navigate Sperax DAO proposals, voting, and protocol upgrades
sperax governance dao voting proposals
By @sperax on 2024-12-16
Compare similar DeFi protocols across features, risks, and yields
defi comparison protocols analysis research
By @sperax on 2024-12-16
Guide complete beginners through their first DeFi experiences
education beginner onboarding tutorial defi-basics
By @sperax on 2024-12-16
Explain and calculate the difference between APY and APR in DeFi
defi education apy apr yields
By @sperax on 2024-12-16
Analyze DeFi protocol business models and revenue generation
defi revenue analysis fundamentals tokenomics
By @sperax on 2024-12-16
Analyze and explain DAO governance proposals and their implications
governance dao voting proposals analysis
By @sperax on 2024-12-16
Calculate and explain impermanent loss scenarios for LP positions
defi liquidity impermanent-loss calculator amm
By @sperax on 2024-12-16
Analyze DAO treasury holdings, runway, and capital allocation
treasury dao capital runway allocation
By @sperax on 2024-12-16
Monitor and manage liquidation risks in lending protocols
lending liquidation risk collateral defi
By @sperax on 2024-12-16
Track and analyze dominant narratives and trends in crypto markets
narrative trends analysis sentiment market-cycles
By @sperax on 2024-12-16
Track and analyze security risks across Sperax smart contracts
sperax security risk audit monitoring
By @sperax on 2024-12-16
Analyze LP pool health, risks, and optimal entry/exit timing
defi liquidity-pools amm analysis risk
By @sperax on 2024-12-16
Expert in SPA token economics, staking rewards, and protocol revenue
sperax spa tokenomics staking governance
By @sperax on 2024-12-16
Minimize gas costs and optimize transaction timing
ethereum gas optimization layer-2 efficiency
By @sperax on 2024-12-16
Identify trading alpha and early signals in DeFi markets
alpha trading signals research opportunities
By @sperax on 2024-12-16
Protect users from front-running, sandwich attacks, and MEV exploitation
mev security front-running flashbots protection
By @sperax on 2024-12-16
Optimize liquidity provision strategies across Sperax pools
sperax liquidity amm yield-farming impermanent-loss
By @sperax on 2024-12-16
Guide users through cross-chain bridging with optimal routes and costs
sperax bridge cross-chain arbitrum layer-2
By @sperax on 2024-12-16
Calculate and optimize staking rewards across protocols
staking rewards calculator pos yields
By @sperax on 2024-12-16
Comprehensive risk assessment framework for DeFi protocols
risk assessment scoring analysis framework
By @sperax on 2024-12-16
Identify and strategize for potential protocol airdrops
airdrop rewards strategy farming allocation
FAQs
General Agent Index and library of specialized AI agents for general use, DeFi, portfolio management, yield optimization, trading, and blockchain automation. Supports linting, automated translation, and CI auto-build for seamless plugin discovery via inde
We found that @nirholas/ai-agents-library demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Research
/Security News
The worm-enabled campaign hit @emilgroup and @teale.io, then used an ICP canister to deliver follow-on payloads.
Research
/Security News
Attackers compromised Trivy GitHub Actions by force-updating tags to deliver malware, exposing CI/CD secrets across affected pipelines.
Security News
ENISA’s new package manager advisory outlines the dependency security practices companies will need to demonstrate as the EU’s Cyber Resilience Act begins enforcing software supply chain requirements.