Axiomeer

AI 에이전트(AI Agents)를 위한 범용 마켓플레이스

91개 이상의 서비스에 접속할 수 있는 단일 API. 자연어(Natural language)로 검색하고, 단 3줄의 코드로 실행하세요.

from axiomeer import AgentMarketplace

client = AgentMarketplace(api_key="axm_xxx")
...

주요 기능 (Features)

기능	설명
91+ APIs	날씨, 금융, 검색, 번역 등
...

기술 스택 (Tech Stack)

백엔드 (Backend): FastAPI, PostgreSQL, Pydantic v2, SQLAlchemy

AI/ML: FAISS, sentence-transformers (all-MiniLM-L6-v2), Ollama

보안 (Security): JWT (HMAC-SHA256), bcrypt (cost 12), SHA-256 API key hashing

인프라 (Infrastructure): Docker, Alembic migrations

아키텍처 (Architecture)

┌──────────────────────────────────────────────────────────────┐
│                        AI AGENT                              │
│            "I need current weather data"                     │
...

빠른 시작 (Quick Start)

# Docker로 클론 및 시작 (PostgreSQL + Redis + API)
git clone https://github.com/ujjwalredd/Axiomeer.git
cd Axiomeer
...

Docker 서비스: PostgreSQL (포트 5433), Redis (6379), API (8000). 쉬운 접근을 위해 기본적으로 인증(Auth)은 비활성화되어 있습니다.

API 문서 (API Documentation)

서버가 실행 중일 때:

Swagger UI: http://localhost:8000/docs
ReDoc: http://localhost:8000/redoc

cURL 예시

# 쇼핑 (자연어로 API 찾기)
curl -X POST http://localhost:8000/shop \
  -H "Content-Type: application/json" \
...

Node.js / fetch 예시

// API 쇼핑
const shop = await fetch("http://localhost:8000/shop", {
  method: "POST",
...

API 키 발급받기

# 회원가입
curl -X POST http://localhost:8000/auth/signup \
  -H "Content-Type: application/json" \
...

SDK 사용하기

pip install axiomeer

from axiomeer import AgentMarketplace

client = AgentMarketplace(api_key="axm_xxxxx")
...

Provider Fallback (프로바이더 폴백)

실패 시 다음 프로바이더(provider)로 자동 재시도하려면 fallback_app_ids를 전달하세요:

execution = client.execute(
    "realtime_weather_agent",
    "weather in Tokyo",
...

Workflow Chaining (워크플로우 체이닝)

각 단계가 {key.field} 플레이스홀더(placeholder)를 통해 이전 출력을 참조할 수 있는 다단계 워크플로우(multi-step workflows)를 실행하세요:

from axiomeer import AgentMarketplace

client = AgentMarketplace(api_key="axm_xxx")
...

SSE Streaming (SSE 스트리밍)

curl -N -X POST http://localhost:8000/execute/stream \
  -H "Content-Type: application/json" \
  -H "Accept: text/event-stream" \
...

JavaScript / TypeScript SDK

npm install @axiomeer/sdk

import { AgentMarketplace } from '@axiomeer/sdk';

const marketplace = new AgentMarketplace({ apiKey: 'axm_xxxxx' });
...

API Categories (API 카테고리)

카테고리	개수	예시
Knowledge (지식)	12	Wikipedia, arXiv, PubMed
...
총합: 91개 API

Manifest Format (매니페스트 형식)

매니페스트(Manifests)는 더 스마트한 실행을 위해 선택 사항인 http_method 및 input_schema를 지원합니다:

{
  "id": "realtime_weather_agent",
  "name": "Realtime Weather Agent",
...

http_method: 프로바이더 호출을 위한 GET (기본값) 또는 POST
input_schema: LLM이 자연어 작업으로부터 파라미터(parameter)를 추출할 수 있도록 지원

Security (보안)

기능	구현 방식
Authentication (인증)	HMAC-SHA256을 사용한 JWT (60분 만료)
...

Performance (성능)

지표	값
API Response (p50)	145ms
...

Project Structure (프로젝트 구조)

├── apps/api/
│   ├── main.py               # FastAPI 애플리케이션 + 모든 엔드포인트 (endpoints)
│   ├── providers.py          # 50개 이상의 프로바이더 엔드포인트
...

Run Tests (테스트 실행)

# 모든 테스트 (의존성이 설치된 Python >=3.10 필요)
pytest tests/ -v

...

SDK Examples (SDK 예제)

SDK 예제

sdk/python/examples/에서 다음을 확인하세요:

basic_usage.py: Shop, execute, list apps
advanced_usage.py: Capabilities, constraints, error handling

SDK

PyPI: pypi.org/project/axiomeer

pip install axiomeer

from axiomeer import AgentMarketplace, RateLimitError

client = AgentMarketplace(api_key="axm_xxx")
...

라이선스

Apache 2.0 — 자세한 내용은 LICENSE를 참조하세요.

문의처

Ujjwal Reddy - ujjwalreddyks@gmail.com
GitHub: @ujjwalredd

Insights

Axiomeer: AI 에이전트를 위한 범용 마켓플레이스

요약

핵심 포인트