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)
git clone https://github.com/ujjwalredd/Axiomeer.git
cd Axiomeer
...
Docker 서비스: PostgreSQL (포트 5433), Redis (6379), API (8000). 쉬운 접근을 위해 기본적으로 인증(Auth)은 비활성화되어 있습니다.
API 문서 (API Documentation)
서버가 실행 중일 때:
cURL 예시
curl -X POST http://localhost:8000/shop \
-H "Content-Type: application/json" \
...
Node.js / fetch 예시
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 | | |
매니페스트(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분 만료) |
| ... | |
| 지표 | 값 |
|---|
| API Response (p50) | 145ms |
| ... | |
Project Structure (프로젝트 구조)
├── apps/api/
│ ├── main.py # FastAPI 애플리케이션 + 모든 엔드포인트 (endpoints)
│ ├── providers.py # 50개 이상의 프로바이더 엔드포인트
...
Run Tests (테스트 실행)
SDK Examples (SDK 예제)
SDK 예제
sdk/python/examples/에서 다음을 확인하세요:
basic_usage.py: Shop, execute, list appsadvanced_usage.py: Capabilities, constraints, error handling
SDK
PyPI: pypi.org/project/axiomeer
from axiomeer import AgentMarketplace, RateLimitError
client = AgentMarketplace(api_key="axm_xxx")
...
라이선스
Apache 2.0 — 자세한 내용은 LICENSE를 참조하세요.
문의처
Ujjwal Reddy - [email protected]
GitHub: @ujjwalredd
