가장 빠르게 체험하는 3가지

Q: 바른을 가장 빠르게 체험하는 방법은 무엇인가요?

설치가 필요 없는 클라우드(api.bareun.ai), 브라우저로 실습하는 구글 Colab, 내 서버에 올리는 도커 세 가지가 있습니다. 클라우드는 5만 어절까지 무료라 가장 가볍게 시작할 수 있습니다.

Q: 클라우드로 바른을 쓰려면 어떻게 하나요?

bareun.ai에서 API키를 발급받고, bareunpy 같은 클라이언트에서 서버 주소 api.bareun.ai, 포트 443으로 연결하면 됩니다. grpc·grpc-web·REST 세 방식을 지원합니다.

Q: 무료로 어디까지 체험할 수 있나요?

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

Q: 도커로 바른을 내 서버에 올리려면 어떻게 하나요?

docker pull bareunai/bareun:latest 로 이미지를 받고 docker run -d -p 5656:5656 -v ~/bareun/var:/bareun/var bareunai/bareun:latest 로 실행한 뒤, docker exec로 -reg 옵션을 써서 API키를 등록하면 됩니다. 도커 배포본은 형태소 분석기를 제공합니다.

Q: 바른은 어떤 개발 언어를 지원하나요?

파이썬(pip install bareunpy), 자바, 자바스크립트, R을 기본 지원하며 엘라스틱서치 플러그인도 제공합니다. REST API와 gRPC도 지원해 다양한 환경에서 한국어 형태소 분석을 쓸 수 있습니다.

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

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

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

방법	설치	적합한 사용자	비고
클라우드	불필요	빠르게 결과만 보고 싶은 분	5만 어절 무료, 맞춤법 검사기 지원
Colab	불필요	코드로 실습·연구하는 분	브라우저만 있으면 됨
도커	명령어 몇 줄	내 서버·폐쇄망에 올릴 분	형태소 분석기 제공

모든 방법은 공통으로 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())

클라우드 무료 구간

클라우드 무료 구간은 5만 어절까지입니다. 무료 구간에서도 api.bareun.ai를 그대로 사용하면 되고, 로그인하면 사용량 통계를 실시간으로 확인할 수 있습니다. 형태소 분석과 맞춤법 검사기를 모두 제공합니다.

방법 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분 설치 가이드와 빠른 시작을 참고하세요.

예시 키를 그대로 쓰지 마세요

위 koba-...는 예시입니다. 자신의 API키로 바꾸세요.

자주 묻는 질문

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

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

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

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

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

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

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

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