Metadata-Version: 2.4
Name: atlas-research
Version: 1.4.2
Summary: Atlas — AI-Powered Knowledge Mapping Platform (SaaS)
Author-email: Han Jeongwoo <jwhan00427@gmail.com>
License: Apache-2.0
Project-URL: Homepage, https://atlaslabs.company
Project-URL: Repository, https://github.com/engineer0427/Atlas
Project-URL: Documentation, https://pypi.org/project/atlas-research/
Project-URL: LiveDemo, https://atlaslabs.company
Project-URL: Issues, https://github.com/engineer0427/Atlas/issues
Keywords: AI,Knowledge,Mapping,Visualization,Knowledge Graph,Machine Learning,SaaS,FastAPI,Next.js
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Science/Research
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: requests>=2.28.0
Requires-Dist: beautifulsoup4>=4.11.0
Requires-Dist: networkx>=3.0
Requires-Dist: pyvis>=0.3.2
Requires-Dist: pydantic>=2.0.0
Requires-Dist: email-validator>=2.2.0
Requires-Dist: fastapi>=0.110.0
Requires-Dist: uvicorn>=0.27.0
Requires-Dist: python-dotenv>=1.0.0
Requires-Dist: stripe>=5.0.0
Requires-Dist: pandas>=1.5.0
Requires-Dist: matplotlib>=3.7.0
Requires-Dist: scikit-learn>=1.3.0
Requires-Dist: rich>=13.7.0
Dynamic: license-file

# 🚀 Atlas — AI-Powered Knowledge Mapping Platform (SaaS)

> **"AI로 지식을 그리다."**
> 데이터 사이의 숨겨진 연결점(**The Missing Link**)을 찾아 지식 구조를 시각화하고, 고도화된 시맨틱 분석을 제공하는 지능형 지식 엔진입니다.

<p align="center">
  <img src="https://raw.githubusercontent.com/engineer0427/Atlas/main/docs/AtlasImage.png" alt="Atlas Logo" width="400"/>
</p>

<p align="center">
  <a href="https://pypi.org/project/atlas-research/">
    <img src="https://img.shields.io/pypi/v/atlas-research?color=blue&style=for-the-badge" alt="PyPI Version"/>
  </a>
  <img src="https://img.shields.io/badge/Commits-1000%2B_In_Progress-orange?style=for-the-badge" alt="Commits"/>
  <img src="https://img.shields.io/badge/Status-Active_Development-green?style=for-the-badge" alt="Status"/>
  <img src="https://img.shields.io/badge/Copyright-Application_Submitted-red?style=for-the-badge" alt="Copyright"/>
</p>

---

## 🛡️ Intellectual Property (IP)
본 프로젝트의 핵심 분석 로직인 **'Atlas Engine v1.4.1'**은 법적 보호를 받는 지식재산권입니다.
* **저작권 접수번호**: 2026-018771 (한국저작권위원회 등록 심사 중)
* **권리자**: 한정우 (Jeongwoo Han) / Atlas Lab
* **핵심 기술**: 지능형 지식 데이터 통합 분석 및 기술 가시화 알고리즘

---

## 🧭 Vision
> **기술적 특이점 이후의 지식 나침반**

단순한 정보의 나열을 넘어, 이종 데이터 간의 유기적인 시맨틱 관계를 발견하고 **지식 전이(Knowledge Transfer)**의 경로를 제시하는 지능형 내비게이터를 지향합니다.

---

## 🧩 Core Value: The "Missing Link"
- **이종 데이터 통합**: 논문, 특허, 뉴스 등 서로 다른 속성의 데이터를 하나의 **헤테로 그래프(Hetero-Graph)**로 구조화합니다.
- **Bridge Score 알고리즘**: 상이한 도메인 데이터 사이의 연관성을 수치화하여 새로운 인사이트(Insight)를 도출하는 독자적 로직을 적용합니다.
- **3D 지식 지형도**: 고차원 벡터 임베딩 데이터를 시각화하여 정보의 논리적 흐름과 위계를 직관적으로 탐색하게 합니다.

---

## 🛠 Engineering Highlights

### 1. 전공 수준의 기술적 도전 (Architectural Decision)
- **Vector Semantic Search**: **pgvector**와 **Neon DB**를 활용하여 단순 키워드 검색을 넘어선 고성능 문맥 유사도 검색 기능을 구현했습니다.
- **SSR Hydration & UX**: Next.js 환경의 렌더링 불일치 문제를 **isMounted 패턴**으로 해결하여 시스템의 일관성을 확보했습니다.
- **Scalable AI Pipeline**: **FastAPI**와 **Koyeb**을 연동하여, 트래픽에 따라 유연하게 확장되는 서버리스 분석 엔진 아키텍처를 설계했습니다.

### 2. 운영 및 지속적 개선 (Continuous Delivery)
- **PyPI 오픈소스 배포**: 핵심 로직을 독립 라이브러리인 [**`atlas-research`**](https://pypi.org/project/atlas-research/)로 배포하여 기술적 재사용성을 입증했습니다.
- **CI/CD 파이프라인**: GitHub Actions를 통해 **1,000회 이상의 점진적 커밋**과 무중단 배포 환경을 구축하여 안정적인 서비스 운영을 실현 중입니다.

### 3. 투명한 의사결정 기록 (ADR)
- **Logically Grounded**: 복잡한 아키텍처 설계 시 LLM과의 기술적 토론을 거쳐 최적의 결정을 도출하며, 그 근거를 [`docs/adr/`](./docs/adr/)에 투명하게 관리합니다.

---

## 🏗 System Architecture

**User Interface** (Next.js/React) → **Analysis Engine** (FastAPI/Python) → **Knowledge Base** (Neon DB/pgvector) → **Intelligence** (OpenAI API)

---

## 🎯 2026 Focus Roadmap
- [x] **Core Engine v1.4.1 저작권 등록 신청 완료 (2026-03-28)**
- [ ] **Semantic Discovery**: 지식 간의 보이지 않는 연결점 추천 로직 고도화
- [ ] **Personal Knowledge Vault**: 유저별 분석 이력 기반 개인화 인사이트 아카이브 강화
- [ ] **Collaborative Mapping**: 실시간 지식 지도 공유 및 공동 편집 인터랙션 도입

---

## 🌐 Contact & Demo
- **Web App**: [https://atlaslab.app](https://atlaslab.app)
- **Developer**: 한정우 (Jeongwoo Han)
- **Company**: Atlas Lab (Solopreneur)
