Metadata-Version: 2.4
Name: scientist-globe
Version: 0.1.0
Summary: 全球计算机科学家 3D 互动地球仪 - 赛博科技风
Author-email: Ricardo <13838152117@139.com>
License: MIT
Project-URL: Homepage, https://github.com/Ricardo-shuo-liu/scientist-globe
Project-URL: Bug Tracker, https://github.com/Ricardo-shuo-liu/scientist-globe/issues
Requires-Python: >=3.10.19
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: fastapi
Requires-Dist: uvicorn
Requires-Dist: jinja2
Provides-Extra: dev
Requires-Dist: build>=1.0.3; extra == "dev"
Requires-Dist: twine>=4.0.2; extra == "dev"
Dynamic: license-file

# Global Computer Scientist 3D Interactive Globe (Package Edition)

---

[🌐 Switch to Chinese Version (切换到中文)](./README_zh.md)

---

<a name="english"></a>
## 🌍 English Version

This is a packaged 3D interactive frontend project as a standard Python library. You can now launch a fully functional, Emoji-interactive cyberpunk globe via simple command-line instructions.

### 🚀 Installation Guide

You can install this library directly via `pip` in the project root directory:

```bash
# Local installation mode
pip install .
```

After installation, you will have a global command `scientist-globe`.

### ✨ Run Command

After installation, just one line of command to start the server and access:

```bash
# Start local server
scientist-globe --serve
```

You can also specify a custom port or address:

```bash
# Start with specified port
scientist-globe --serve --port 9000 --host 0.0.0.0
```

Access URL: 👉 **[http://localhost:8000](http://localhost:8000)**

### 📦 Project Structure (Package Layout)

The project has been refactored into a standard Python package structure (`src` layout) for easy integration and distribution:

```text
.
├── pyproject.toml             # Project metadata and Entry Points configuration
├── README.md                  # Run instructions
└── src/
    └── scientist_globe/       # Core package
        ├── app.py             # FastAPI application instance
        ├── cli.py             # CLI entry point (argparse implementation)
        └── static/            # Globe static frontend resources (HTML/JS/CSS)
```

### 🛠️ Tech Stack
- **Backend**: [FastAPI](https://fastapi.tiangolo.com/) + [Uvicorn](https://www.uvicorn.org/)
- **Frontend**: [Three.js](https://threejs.org/) (3D Rendering)
- **Packaging**: [setuptools](https://setuptools.pypa.io/) (pyproject.toml)

### 👨‍🚀 About the Developer
- **Author**: Ricardo
- **Location**: Zhengzhou, Henan, China


---
