semvec/pypi-packages huggingface dataset:
philosim 2025.12.21095947
A new package that leverages the power of llmatch-messages to provide structured insights into complex philosophical and scientific topics, such as the simulation hypothesis. Users can input a specifi
License: MIT
Requires Python: >=3.9

# Philosim
[![PyPI version](https://badge.fury.io/py/philosim.svg)](https://badge.fury.io/py/philosim)
[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT)
[![Downloads](https://static.pepy.tech/badge/philosim)](https://pepy.tech/project/philosim)
[![LinkedIn](https://img.shields.io/badge/LinkedIn-blue)](https://www.linkedin.com/in/eugene-evstafev-716669181/)


Philosim is a Python package that leverages the power of llmatch-messages to provide structured insights into complex philosophical and scientific topics, such as the simulation hypothesis.

## Installation

Installation is simple:
```
pip install philosim
```
## Usage

The main function `philosim` takes three parameters:

- `user_input`: a string containing the topic or question you want to explore.
- `llm`: an optional parameter for the LangChain LLM instance to use. If not provided, the package will use the `ChatLLM7` instance from `langchain_llm7` by default.
- `api_key`: an optional parameter for the LLM7 API key. If not provided, the package will use the `LLM7_API_KEY` environment variable or the default free tier API key.

```python
from philosim import philosim

# Using the default llm
response = philosim(user_input)

# Using a custom llm instance (e.g. openai)
from langchain_openai import ChatOpenAI
llm = ChatOpenAI()
response = philosim(user_input, llm=llm)

# Using a custom llm instance (e.g. anthropic)
from langchain_anthropic import ChatAnthropic
llm = ChatAnthropic()
response = philosim(user_input, llm=llm)

# Using a custom llm instance (e.g. google)
from langchain_google_genai import ChatGoogleGenerativeAI
llm = ChatGoogleGenerativeAI()
response = philosim(user_input, llm=llm)

# Using a custom llm7 api key
response = philosim(user_input, api_key="your_api_key")
```
## Note on LLM Rate Limits

The default rate limits for LLM7 free tier are sufficient for most use cases of this package. If you need higher rate limits for LLM7, you can pass your own API key via environment variable `LLM7_API_KEY` or via passing it directly like `philosim(user_input, api_key="your_api_key")`. You can get a free API key by registering at https://token.llm7.io/.

## Issues

To report any issues or request features, please visit our GitHub repository: <https://github.com/chigwell/philosim/issues>

## Author

Philosim was created by Eugene Evstafev (<hi@eugene.plus>)

## License

Philosim is released under the [MIT License](https://opensource.org/licenses/MIT).

## Changelog

[Add changelog here]
sop-online 1.1.0
SOP Online - Interactive web platform for executing Standard Operating Procedures (SOP) with embedded scripts
License: MIT
Requires Python: >=3.10

# SOP Online - 标准操作流程执行工具

一个交互式的SOP（标准操作流程）在线执行工具，借鉴Jupyter Notebook的设计理念，支持在Markdown文档中嵌入可执行脚本，提供实时输出和交互式体验。

## ✨ 功能特性

- **交互式SOP** - 在Markdown中嵌入可执行脚本，类似Jupyter Notebook
- **交互式输入** - 支持在脚本执行过程中接收用户输入（如`read`命令）
- **实时执行** - WebSocket实现脚本实时输出流
- **独立输出** - 每个SOP步骤下方有独立的输出区域
- **多文档支持** - 支持多个SOP文档切换
- **主题切换** - 支持明亮和暗色主题
- **标准流程** - 适用于企业标准操作流程的展示和执行
- **完整测试** - 包含102个单元测试和集成测试

## 🖼️ 截图预览

![SOP Online界面截图](docs/screenshot.png)

## 🚀 快速开始

### 环境要求
- Python 3.14+
- 现代浏览器

### 安装

```bash
# 直接安装（推荐）
pip install sop-online

# 或者从源码安装
git clone https://github.com/lengmoXXL/sop_online.git
cd sop_online
pip install .
```

### 使用方法

```bash
# 启动服务（使用默认content目录）
sop_online content/

# 指定自定义SOP目录
sop_online /path/to/my/sop/documents/

# 指定端口
sop_online content/ --port 9000

# 允许外部访问
sop_online content/ --host 0.0.0.0

# 访问应用
open http://localhost:8000
```

**注意**: 修改代码后请手动重启服务以应用更改。

## 📦 发布信息

### PyPI安装

```bash
pip install sop-online
```

**PyPI链接**: https://pypi.org/project/sop-online/

### 版本

- 当前版本: 1.1.0
- Python要求: >=3.14

### 更新日志

#### v1.1.0 (2025-12-21)
- ✨ 新增交互式输入功能，支持在脚本执行过程中接收用户输入
- 🧪 新增25个JavaScript单元测试
- 📁 重组测试目录结构，统一管理测试文件
- 🔧 优化WebSocket通信，支持stdin双向交互
- ✅ 所有102个测试全部通过

### 许可证

MIT License

### GitHub仓库

- 源码: https://github.com/lengmoXXL/sop_online
- 问题反馈: https://github.com/lengmoXXL/sop_online/issues

## 🧪 测试

本项目包含完整的测试套件，总计102个测试用例。

### 运行所有测试

```bash
# 运行所有测试（单元测试 + 集成测试）
pytest src/ src/integration_tests/ -v
```

### 分别运行测试

```bash
# Python 单元测试
pytest src/tests/ -v

# JavaScript 单元测试
cd src/tests/js
npm test

# 集成测试
pytest src/integration_tests/ -v
```

### 测试覆盖率

- **JavaScript 测试**: 25个测试用例（使用Jest + JSDOM）
- **Python 单元测试**: 64个测试用例
- **集成测试**: 13个测试用例
- **总测试数**: 102个，全部通过 ✅

测试覆盖：
- App类初始化和基本功能
- 全局函数（executeScript、copyCode、sendInput）
- WebSocket事件处理
- 文件扫描和Markdown解析
- 插件管理系统
- 脚本执行器
- 交互式输入功能

## 📝 开发指南

### 本地开发

```bash
# 克隆仓库
git clone https://github.com/lengmoXXL/sop_online.git
cd sop_online

# 创建虚拟环境
python -m venv .venv
source .venv/bin/activate

# 安装依赖
pip install -e .
pip install -r requirements-test.txt

# 安装JavaScript测试依赖（仅测试需要）
cd src/tests/js
npm install

# 返回根目录
cd /path/to/sop_online

# 运行所有测试
pytest src/ src/integration_tests/ -v
```

### 发布到PyPI

```bash
# 构建包
python -m build

# 上传到PyPI
twine upload dist/*
```

或者使用GitHub Actions进行自动发布。

---

**SOP Online** - 让标准操作流程更易于理解和执行 📖