semvec/pypi-packages huggingface dataset:
finance-chatbot 1.0.12
An intelligent document analysis and Q&A system for Santa Clara University Finance Department
License: MIT
Requires Python: >=3.8
Keywords: chatbot, finance, document-analysis, qa-system, streamlit, flask, generative-ai

PyPI installation
-------------------
pip install finance-chatbot


Prerequisites
----------------
Python 3.8+
pip (Python package manager)
Google Gemini API Key
Ollama (optional)


Installation
------------------
1. Clone the Repository

```console
git clone https://github.com/pradeept3/finance-chatbot.git
cd finance-chatbot
```
2. Install Dependencies
```python
pip install -r requirements.txt
```


3. update the /backend/.env file:
  
  ```css
  GOOGLE_API_KEY=your_google_api_key_here
  OLLAMA_API_URL=http://localhost:11434
  PORT=5000
  UPLOAD_DIR=./uploaded_documents
  MAX_UPLOAD_SIZE=50
  ```


4. Running the Application
    
  ```python
  Start Backend Server
    Open Terminal/ Command prompt:
    Goto the finance-chatbot folder and type cd backend
    python app.py
    Backend runs on: http://127.0.0.1:5000
  Start Frontend (in new terminal)
    Goto the finance-chatbot folder and type cd frontend
    streamlit run main.py
    Frontend runs on: http://localhost:8501
  ```

5. Checklist Before Deployment

  A.  All dependencies installed (pip install -r requirements.txt)
  B.  .env file configured with API keys
  C.  Backend tested (python app.py)
  D.  Frontend tested (streamlit run main.py)
  E.  Sample documents uploaded and searched
  F.  Admin/Student/Guest roles working
upx-installer 1.0.0
自动安装UPX可执行文件到Windows系统
License: MIT
Requires Python: >=3.7
Keywords: upx, installer, executable, compression, windows

# UPX Installer

一个Python包，自动安装UPX可执行文件到Windows系统的C:\Windows目录。

## 功能特性

- **自动安装**: 安装Python包时自动将UPX复制到C:\Windows目录
- **卸载功能**: 提供完整的卸载功能，可恢复备份文件
- **验证机制**: 验证UPX安装的正确性
- **备份恢复**: 安装时自动备份现有UPX文件
- **跨平台**: 虽然主要针对Windows，但在其他系统上也可安全安装（不复制文件）

## 安装方法

### 从PyPI安装（推荐）

```bash
pip install upx-installer
```

安装完成后，UPX将自动安装到C:\Windows目录。

### 手动安装（开发模式）

```bash
# 克隆仓库
git clone https://github.com/example/upx-installer.git
cd upx-installer

# 安装开发版本
pip install -e .
```

## 使用方法

### 命令行工具

安装后，可以使用 `upx-installer` 命令行工具：

```bash
# 安装UPX（如果未自动安装）
upx-installer install

# 强制重新安装
upx-installer install --force

# 安装时不创建备份
upx-installer install --no-backup

# 卸载UPX
upx-installer uninstall

# 卸载并恢复备份
upx-installer uninstall --restore-backup

# 验证安装
upx-installer verify

# 检查UPX版本
upx-installer version
```

### Python API

```python
import upx_installer

# 安装UPX
upx_installer.install_upx()

# 强制安装
upx_installer.install_upx(force=True)

# 卸载UPX
upx_installer.uninstall_upx()

# 验证安装
upx_installer.verify_installation()
```

## 权限要求

在Windows系统上，写入C:\Windows目录需要管理员权限。如果遇到权限错误：

1. **以管理员身份运行命令提示符/PowerShell**
2. 或手动将UPX复制到C:\Windows目录

## 技术细节

### 文件位置

- **UPX源文件**: 包内的 `upx_installer/data/upx.exe`
- **安装目标**: `C:\Windows\upx.exe`
- **安装记录**: `%USERPROFILE%\.upx_installer_record.json`
- **备份文件**: `%USERPROFILE%\.upx_installer_backup\`

### 安装验证

安装时会计算UPX文件的MD5哈希值并保存到安装记录中。验证时比较当前文件的哈希值与记录值，确保文件未被修改。

## 开发指南

### 环境设置

```bash
# 安装开发依赖
pip install -e ".[dev]"

# 运行测试
pytest tests/
```

### 构建包

```bash
# 构建源码包和wheel
python setup.py sdist bdist_wheel

# 或使用build工具
python -m build
```

### 发布到PyPI

```bash
# 上传到PyPI
twine upload dist/*
```

## 常见问题

### Q: 安装时出现权限错误怎么办？
**A**: 请以管理员身份运行命令提示符或PowerShell，然后重新安装。

### Q: 非Windows系统可以使用吗？
**A**: 可以安装包，但不会复制UPX文件（因为目标路径是C:\Windows）。

### Q: 如何手动安装UPX？
**A**: 只需将UPX可执行文件复制到C:\Windows目录或系统PATH中的任何目录。

### Q: 这个包包含UPX的哪个版本？
**A**: 包含当前包版本的UPX可执行文件。使用 `upx-installer version` 查看具体版本。

## 许可证

MIT License - 详见 [LICENSE](LICENSE) 文件。

## 贡献

欢迎提交Issue和Pull Request！

1. Fork仓库
2. 创建功能分支 (`git checkout -b feature/amazing-feature`)
3. 提交更改 (`git commit -m 'Add amazing feature'`)
4. 推送到分支 (`git push origin feature/amazing-feature`)
5. 开启Pull Request

## 免责声明

本软件按"原样"提供，不提供任何明示或暗示的担保。使用UPX请遵守其原始许可证。