1name: field(String)

에이전틱 TypeScript 프레임워크

한 줄 쓰고, 어디에나 배포. 말 그대로

웹, iOS, Android, macOS, Windows, Linux. 서버와 데이터베이스. 그리고 사용자가 이미 쓰고 있는 AI 에이전트까지.

시작하기

화면 → 에이전트

구현한 화면이 곧 에이전트 인터페이스

평범한 말로 부탁하면, 에이전트가 같은 화면을 사용자의 세션 그대로 다룹니다.

1× · 실제 속도, 배속 없음

서버 → AI

구현한 서버가 곧 MCP 서버

MCP 클라이언트에 앱 주소만 넣으면, 같은 가드를 지나 엔드포인트를 부릅니다.

1× · 실제 속도, 배속 없음

코드 하나 → 모든 플랫폼

모든 플랫폼을 한 번에

같은 앱이 iOS·Android·macOS 앱과 웹으로 동시에 돌고, 코드를 저장하면 모든 화면이 함께 바뀝니다. 웹은 SSR이라 SEO도 신경 쓰지 않아도 알아서 됩니다.

  1. Android에서 조작하면 나머지가 따라옵니다
  2. 스택 전환
  3. 바텀 시트
  4. 뒤로 가기도 모든 화면이 함께
  5. 페이드 전환
  6. 스케일 아웃 전환
  7. 스택 전환
  8. Android에서 메모를 쓰면…
  9. …DB에 저장되고 모든 화면에 실시간으로
  • iOS
  • Android
  • Web (SSR)
  • macOS
  • Windows
  • Linux

akan start · akan start-ios · akan start-android · akan start-desktop

올인원 → 스케일업

서버와 DB까지 한 번에, 프로토타입부터 IPO까지

보통은 규모가 커지면 프로토타입을 다시 짭니다. Akan에서는 노트북에서 쓴 코드가 IPO 때도 그대로 돌고, 커지는 건 배포뿐입니다.

프로토타입

첫날부터 실행

akan start에 서버와 DB가 함께 옵니다. 설치할 것도, 연결할 것도 없습니다.

출시

컨테이너 하나로 출시

DB까지 담긴 앱 전체가 컨테이너 하나로 배포됩니다.

성장

코드는 그대로, 인스턴스만 추가

트래픽이 늘면 같은 앱을 더 띄워 나눠 받습니다.

IPO

서버는 여러 대, 코드는 그대로

서버 한 대로 부족해지면 Postgres·Redis와 함께 여러 서버로 펼칩니다.

name: field(String)첫 커밋부터 IPO까지 코드베이스 하나
single · multiple · cluster단계별 운영 방식

성능

속도 때문에 다시 짤 일도 없습니다

DB, SSR, 인증, 에이전트가 모두 들어 있는데도 가장 가벼운 Bun 프레임워크들과 속도를 나란히 합니다. 빨리 뜨고 메모리도 적게 써서, 인스턴스를 늘리기도 빠르고 저렴합니다.

  • 123K

    초당 요청

  • 102 ms

    시작 시간

  • 57 MB

    대기 메모리

초당 요청 수

  • raw Bun.serve138,072
  • ElysiaJS137,780
  • Hono129,926
  • Akan.js123,319
  • Fastify(Node)86,682

Apple M4 Pro MacBook Pro · production 빌드 · 동시 사용자 50명벤치마크 전체 보기

작동 원리

Single source of business

에이전트가 다루는 화면, AI가 부르는 서버, 모든 플랫폼의 앱. 어느 것도 두 번 쓰지 않습니다. 전부 이런 선언 한 줄에서 파생되니, 서로 어긋날 곳이 없습니다.

1name: field(String)

1

한 줄

선언된 한 줄로

사람이 쓰든 에이전트가 쓰든, 필드를 더하는 일은 이름과 타입, 선언 한 줄입니다. DB, API, 화면, 에이전트 도구까지 모두 이 한 줄에서 나오니 확인할 것도 이 한 줄뿐입니다.

×8

8 레이어

구현 레이어가 함께 반영되고,

그 한 줄이 스키마, 쿼리, 서비스, API, fetch, 클라이언트 타입, 상태, UI prop까지 이어집니다. 보통은 하나씩 고쳐야 하는 8곳이 함께 바뀌니, 따라 고칠 곳도 빠뜨릴 곳도 없습니다.

×6

6 플랫폼

모든 플랫폼에 닿고,

같은 코드가 SEO 웹, iOS·Android 앱, macOS·Windows·Linux 데스크톱 앱으로 배포됩니다. 감싼 웹사이트가 아니라 네이티브 수준의 화면 전환까지 갖춘 채로요. 보조를 맞출 코드베이스 여섯 개가 아니라 관리할 구현 하나뿐입니다.

×2

사람과 에이전트

사람과 에이전트 모두에게

가드를 통과한 엔드포인트는 MCP 도구가, 화면의 컨트롤은 인페이지 에이전트 도구가 됩니다. 사람과 같은 가드를 거쳐서요. 앞에서 본 화면과 서버도 모두 그 한 줄에서 시작합니다.

만드는 일도 에이전트가

유지보수성, 관측성, 신속성

Human in the loop 최소화

AI는 이미 코드를 잘 씁니다. 느려지는 건 사람이 끼어드는 순간입니다. 질문에 답하고, 구조를 확인하고, 로그를 읽어 주고, 다시 지시하는 일. Akan은 그 답을 규칙과 도구에 정해 두어 에이전트가 스스로 검증하고, 사람은 결과만 승인하면 되게 합니다.

  1. 01

    유지보수성

    컨벤션은 문서가 아니라 lint 규칙입니다. 모든 파일이 규칙대로 자리 잡아 한 사람이 쓴 코드처럼 읽히고, 잘못 간 코드는 리뷰에 닿기 전에 빌드에서 막힙니다.

  2. 02

    관측성

    모든 로그에 요청의 trace가 붙고, 개발 세션은 로그를 파일 하나에 그대로 남깁니다. 에이전트가 직접 읽고 trace를 따라가 원인을 찾으니, 로그를 복사해 붙여 줄 필요가 없습니다.

  3. 03

    신속성

    필드 하나는 8곳 수정이 아니라 선언 한 줄이고, 워크플로 MCP로 에이전트가 변경을 계획하고 적용하고 검증까지 스스로 합니다. 사람은 배선이 아니라 비즈니스 변경만 봅니다.

우리가 말하는 에이전틱 풀스택

코드는 사람과 기계가 대화하는 언어입니다. AI가 발전해도 코드를 안 보게 되는 게 아니라, 점점 더 보기 편해져야만 합니다.쓰는 일은 에이전트가 맡고, Akan은 그 코드를 한눈에 읽힐 만큼 짧고 일관되게 만듭니다.

빌드에서 라이브 URL까지

Akan Cloud는 Akan 앱을 위해 만든 배포 플랫폼입니다. CLI에서 로그인하고, 미리보기를 공유하고, 빌드해서 라이브로 내보내세요.

Akan Cloud 열기
  1. 01

    $ akan login

    이 컴퓨터에서 Akan Cloud에 로그인합니다.

  2. 02

    $ akan tunnel <app>

    배포 전에 실행 중인 앱을 공개 URL로 공유합니다.

  3. 03

    $ akan build <app>

    Akan Cloud가 돌릴 프로덕션 결과물을 빌드합니다.

에이전틱 TypeScript 프레임워크

읽는 건 사람이,쓰는 건 에이전트가

Akan.js(https://akanjs.com) 워크스페이스를 새로 만들어 줘.

1. Bun 1.4 이상이 설치돼 있는지 확인해 줘(`bun --version`). 없거나 버전이 낮으면 https://bun.sh 안내대로 설치하거나 업그레이드해 줘.
2. 워크스페이스 이름과 첫 앱 이름을 물어봐 줘. 짧은 영문 소문자로, 아래에 적어 뒀다면 그걸 쓰면 돼.
3. 이 디렉터리에서 `bunx create-akan-workspace@latest <워크스페이스> --app <앱>`을 실행해 줘. akan CLI를 전역으로 설치하고, ./<워크스페이스>를 만들어 의존성까지 설치해.
4. ./<워크스페이스> 안에서 `akan start <앱>`으로 개발 서버를 백그라운드에 띄우고, 출력된 주소(기본 http://localhost:8282)가 열리는지 확인해 줘.
5. 다 되면 알려 주고, ./<워크스페이스> 안에서 너를 다시 열라고 안내해 줘. 프로젝트의 Akan MCP 서버와 AGENTS.md 규칙은 거기서 로드돼.

MIT 라이선스 하에 배포되었습니다.

내 AI에 이 문서 연결하기

MCPhttps://akanjs.com/mcp
Copyright © 2026 Akan.js 모든 권리 보유.시스템 관리자bassman