> ## Documentation Index
> Fetch the complete documentation index at: https://avala.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# 빠른 시작

> 60초 이내에 Avala를 시작하세요

<Tip>
  **사전 요구 사항:** Avala 계정이 필요합니다. [avala.ai에서 가입](https://avala.ai)하거나 SDK로 프로그래밍 방식으로 생성한 후(아래 참조), \*\*[설정 > 보안](https://avala.ai/settings?section=security)\*\*에서 API 키를 생성하세요.
</Tip>

<CodeGroup>
  ```bash Python theme={null}
  pip install avala
  ```

  ```bash TypeScript theme={null}
  npm install @avala-ai/sdk
  ```

  ```bash CLI theme={null}
  curl -fsSL https://avala.ai/install.sh | bash
  ```
</CodeGroup>

<CodeGroup>
  ```python Python theme={null}
  from avala import Client

  client = Client(api_key="avk_your_api_key")

  for dataset in client.datasets.list():
      print(dataset.name, dataset.item_count)
  ```

  ```typescript TypeScript theme={null}
  import Avala from "@avala-ai/sdk";

  const avala = new Avala({ apiKey: "avk_your_api_key" });

  const page = await avala.datasets.list();
  page.items.forEach(d => console.log(d.name, d.itemCount));
  ```

  ```bash CLI theme={null}
  export AVALA_API_KEY="avk_your_api_key"
  avala datasets list
  ```

  ```bash cURL theme={null}
  curl https://api.avala.ai/api/v1/datasets/ \
    -H "X-Avala-Api-Key: avk_your_api_key"
  ```
</CodeGroup>

이것으로 끝입니다. 아래는 무슨 일이 일어나고 있는지와 다음에 할 수 있는 것에 대한 단계별 안내입니다.

***

## 계정 생성

[avala.ai](https://avala.ai)에서 가입하거나 프로그래밍 방식으로 계정을 생성할 수 있습니다. SDK `signup` 함수는 API 키가 필요 없으며 성공 시 반환합니다.

<CodeGroup>
  ```python Python theme={null}
  from avala import signup

  result = signup(email="dev@acme.com", password="SecurePass123!")
  print(f"API Key: {result.api_key}")
  ```

  ```typescript TypeScript theme={null}
  import { signup } from "@avala-ai/sdk";

  const result = await signup({ email: "dev@acme.com", password: "SecurePass123!" });
  console.log(`API Key: ${result.apiKey}`);
  ```

  ```bash cURL theme={null}
  curl -X POST https://api.avala.ai/api/v1/signup/ \
    -H "Content-Type: application/json" \
    -d '{"email": "dev@acme.com", "password": "SecurePass123!"}'
  ```
</CodeGroup>

***

## API 키 받기

1. [Mission Control](https://avala.ai)에 로그인합니다.
2. \*\*[설정 > 보안](https://avala.ai/settings?section=security)\*\*으로 이동합니다.
3. **API 키 생성**을 클릭하고, 이름을 지정하고, 범위를 선택하고, 키를 복사합니다.

<Warning>
  API 키는 생성 시에만 표시됩니다. 대화 상자를 닫기 전에 안전한 곳에 저장하세요.
</Warning>

환경 변수로 설정하면 모든 SDK와 CLI가 자동으로 인식합니다:

```bash theme={null}
export AVALA_API_KEY="avk_your_api_key"
```

## 데이터셋 목록

<CodeGroup>
  ```python Python theme={null}
  from avala import Client

  client = Client()  # 환경에서 AVALA_API_KEY 읽기

  for dataset in client.datasets.list():
      print(f"{dataset.name} — {dataset.item_count} items")
  ```

  ```typescript TypeScript theme={null}
  import Avala from "@avala-ai/sdk";

  const avala = new Avala();  // 환경에서 AVALA_API_KEY 읽기

  const page = await avala.datasets.list();
  for (const d of page.items) {
    console.log(`${d.name} — ${d.itemCount} items`);
  }
  ```

  ```bash CLI theme={null}
  avala datasets list
  ```

  ```bash cURL theme={null}
  curl https://api.avala.ai/api/v1/datasets/ \
    -H "X-Avala-Api-Key: $AVALA_API_KEY"
  ```
</CodeGroup>

## 프로젝트 목록

<CodeGroup>
  ```python Python theme={null}
  for project in client.projects.list():
      print(f"{project.name} ({project.status})")
  ```

  ```typescript TypeScript theme={null}
  const projects = await avala.projects.list();
  projects.items.forEach(p => console.log(`${p.name} (${p.status})`));
  ```

  ```bash CLI theme={null}
  avala projects list
  ```

  ```bash cURL theme={null}
  curl https://api.avala.ai/api/v1/projects/ \
    -H "X-Avala-Api-Key: $AVALA_API_KEY"
  ```
</CodeGroup>

## 내보내기 생성

<CodeGroup>
  ```python Python theme={null}
  export = client.exports.create(project="proj_uid_here")
  print(f"Export {export.uid}: {export.status}")
  ```

  ```typescript TypeScript theme={null}
  const exp = await avala.exports.create({ project: "proj_uid_here" });
  console.log(`Export ${exp.uid}: ${exp.status}`);
  ```

  ```bash CLI theme={null}
  avala exports create --project proj_uid_here
  ```

  ```bash cURL theme={null}
  curl -X POST https://api.avala.ai/api/v1/exports/ \
    -H "X-Avala-Api-Key: $AVALA_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{"project": "proj_uid_here"}'
  ```
</CodeGroup>

<Info>
  내보내기는 비동기적으로 실행됩니다. `client.exports.get(uid)` 또는 `avala exports get <uid>`로 완료될 때까지 상태를 폴링하세요.
</Info>

## 다음 단계

<CardGroup cols={3}>
  <Card title="Python SDK" icon="python" href="/docs/ko/sdks/python">
    비동기 지원, 페이지네이션, 오류 처리, 완전한 타입 힌트.
  </Card>

  <Card title="TypeScript SDK" icon="js" href="/docs/ko/sdks/typescript">
    의존성 없음. Node.js, Deno, Bun에서 작동.
  </Card>

  <Card title="CLI 레퍼런스" icon="terminal" href="/docs/ko/sdks/cli">
    터미널에서 데이터셋, 프로젝트, 내보내기, 스토리지를 관리하세요.
  </Card>
</CardGroup>