Cognee 설정 가이드
이 문서는 Cognee를 설치하고 첫 번째 AI 메모리 예제를 실행하는 방법을 설명합니다.
1. 전제 조건
- Python: 3.9 ~ 3.13 버전 지원 (3.10 이상 권장).
- 패키지 관리:
uv사용 권장. - LLM API: OpenAI(기본값), Gemini, Anthropic, Ollama 등 지원.
2. 설치
# 가상 환경 생성 및 활성화
uv venv && source .venv/bin/activate
# Cognee 설치
uv pip install cognee3. 환경 설정 (.env)
기본적으로 OpenAI를 사용하며, .env 파일에 API 키를 설정해야 합니다.
LLM_API_KEY="your_openai_api_key"4. 빠른 시작 예제 (Async Python)
Cognee는 비동기(async/await) 방식으로 작동합니다.
import cognee
import asyncio
async def main():
# 데이터 재설정 (선택 사항)
await cognee.prune.prune_data()
# 1. 데이터 추가
await cognee.add("Cognee turns documents into AI memory.")
# 2. 인지화 (지식 그래프 구축)
await cognee.cognify()
# 3. 검색
results = await cognee.search(query_text="What does Cognee do?")
for result in results:
print(result)
if __name__ == '__main__':
asyncio.run(main())5. CLI 도구
명령줄에서도 동일한 기능을 수행할 수 있습니다:
cognee addcognee cognifycognee searchcognee ui(대시보드 실행)