바른을 가장 빠르게 체험하는 3가지 방법 (클라우드 / Colab / 도커)

바른(bareun)을 처음 써보는 가장 빠른 길은 셋 중 하나입니다. 클라우드(api.bareun.ai), 구글 Colab, 도커. 설치가 부담스러우면 클라우드나 Colab으로 즉시 시작하고, 내 서버에 올려보고 싶으면 도커를 쓰세요. 클라우드는 5만 어절까지 무료라 가장 가볍게 시작할 수 있습니다.

어떤 방법을 골라야 하나요?

모든 방법은 공통으로 bareun.ai에서 발급받은 API키(koba-...)가 필요합니다.

방법 1 — 클라우드(api.bareun.ai)로 즉시 사용하기

설치 없이 가장 빠르게 쓰는 방법입니다. 클라우드 서버는 api.bareun.ai, 포트 443, TLS 암호화로 제공됩니다. grpc·grpc-web·REST 세 방식을 지원합니다. 클라우드 API 사용법은 클라우드 API에 자세히 정리되어 있습니다.

from bareunpy import Tagger

API_KEY = "koba-ABCDEFG-1234567-LMNOPQR-7654321"  # 본인 키로 교체
tagger = Tagger(API_KEY, 'api.bareun.ai', 443)
res = tagger.tags(["바른을 클라우드로 써봅니다."])
print(res.pos())

방법 2 — 구글 Colab으로 실습하기

브라우저만 있으면 됩니다. Colab 노트북에서 라이브러리를 설치하고 클라우드 서버에 붙으면 바로 결과를 볼 수 있습니다. 단계별 실습은 Colab으로 시작하기를 참고하세요.

!pip install bareunpy

from bareunpy import Tagger
API_KEY = "koba-ABCDEFG-1234567-LMNOPQR-7654321"  # 본인 키로 교체
tagger = Tagger(API_KEY, 'api.bareun.ai', 443)
print(tagger.tags(["바른을 코랩에서 실습해봅니다."]).pos())

연구·실습 목적이라면 무료 구간만으로도 충분히 다양한 문장을 분석해볼 수 있습니다.

방법 3 — 도커로 내 서버에 올리기

내 환경에 직접 올려보고 싶다면 도커가 가장 빠릅니다.

docker pull bareunai/bareun:latest
mkdir -p ~/bareun/var
docker run -d -p 5656:5656 -v ~/bareun/var:/bareun/var bareunai/bareun:latest
docker exec bareun /bareun/bin/bareun -reg koba-ABCDEFG-1234567-LMNOPQR-7654321

도커 배포본은 5656 포트로 서비스합니다. 더 자세한 단계는 도커 10분 설치 가이드와 빠른 시작을 참고하세요.

자주 묻는 질문

Q. 가장 빠른 방법은 무엇인가요?

설치가 전혀 필요 없는 클라우드(api.bareun.ai)입니다. API키만 있으면 바로 호출됩니다.

Q. Colab과 클라우드는 무엇이 다른가요?

Colab은 코드를 실행하는 노트북 환경이고, 분석 자체는 클라우드 서버(api.bareun.ai)가 처리합니다. 둘은 함께 쓰입니다.

Q. 무료로 어디까지 써볼 수 있나요?

클라우드 무료 구간 5만 어절 안에서 형태소 분석과 맞춤법 검사기를 모두 체험할 수 있습니다.

Q. 어떤 개발 언어를 지원하나요?

파이썬(pip install bareunpy), 자바, 자바스크립트, R을 기본 지원하며, 엘라스틱서치 플러그인도 제공합니다. REST API와 gRPC도 지원합니다.

관련 문서

• 클라우드 API
• Colab으로 시작하기
• 도커 10분 설치 가이드
• 빠른 시작