semvec/pypi-packages huggingface dataset:
feature-suggestion-agent 0.1.2
An intelligent agent for suggesting features for machine learning datasets
Requires Python: >=3.10

# Feature Suggestion Agent

The **Feature Suggestion Agent** is an intelligent agent that uses LLMs (Large Language Models) to automatically generate and suggest features for machine learning tasks. It can produce feature definitions, formulas, reasoning, and SQL queries for dataset transformation.

## Features

- Accepts dataset metadata, target information, and modeling approach.
- Generates new feature suggestions using an LLM.
- Provides:
  - Feature name (`title`)
  - Columns used (`columns_involved`)
  - Calculation logic (`formula_logic`)
  - Reasoning for usefulness
  - SQL to create the feature
  - Aggregation/grouping info for window or group operations
- Parses LLM responses into validated Pydantic models.

---

## 📦 Installation

### Prerequisites
- Python 3.11+
- Git
- [**uv**](https://docs.astral.sh/uv/getting-started/installation/) – A fast Python package and environment manager.
    -   For a quick setup on macOS/Linux, you can use:
        ```bash
        curl -LsSf https://astral.sh/uv/install.sh | sh
        ```

### Setup

1. **Clone the repository**
   ```bash
   git clone https://github.com/stepfnAI/feature_suggestion_agent.git
   cd feature_suggestion_agent/
   git checkout dev
   ```

2. **Set up the virtual environment and install dependencies**
   This command creates a `.venv` folder in the current directory and installs all required packages.
    ```bash
    uv sync --extra dev
    source .venv/bin/activate
    ```

3. **Clone and install the `sfn_blueprint` dependency:**
    The agent requires the `sfn_blueprint` library. The following commands clone it into a sibling directory and install it in editable mode.
    
   ```bash
   cd ..
   git clone https://github.com/stepfnAI/sfn_blueprint.git
   cd sfn_blueprint
   git switch dev
   uv pip install -e .
   cd ../feature_suggestion_agent
   ```

4. **Set up environment variables**
   ```bash   
   # Optional: Configure LLM provider (default: openai)
   export LLM_PROVIDER="your_llm_provider"
   
   # Optional: Configure LLM model (default: gpt-4.1-mini)
   export LLM_MODEL="your_llm_model"
   
   # Required: Your LLM API key (Note: If LLM provider is opeani then 'export OPENAI_API_KEY', if it antropic 'export ANTROPIC_API_KEY', use this accordingly as per LLM provider )
   export OPENAI_API_KEY="your_llm_api_key"
   ```

## 🛠️ Usage

### Basic Usage
```bash
python examples/basic_usage.py
```

## 🧪 Testing
Run the test file:
```bash
pytest -v -s tests/test1.py
```
## 🏗️ Architecture

The Target Synthesis Agent is built with a modular architecture:

- **Core Components**:
  - `agent.py`: Base agent implementation
  - `models.py`: Data models and schemas
  - `constants.py`: prompts
  - `config.py`: model configurations


- **Dependencies**:
  - `sfn-blueprint`: Core framework and utilities
  - `pydantic`: Data validation
  

## 🤝 Contributing

## 📝 License

[Add your license information here]

## 🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

## 📧 Contact
puneet@stepfunction.ai
qnvip-mcp 0.0.43
青年优品mcp工具集
Requires Python: >=3.10

# 青年优品mcp工具集

## 支持功能
1. markdown的table 转 excel `python util/md2excel.py xxx.md xxx.xlsx` 

## 如何使用

### 方式1: 直接安装使用
```bash
# 安装你的服务
pip install -i https://pypi.org/simple/  -U qnvip-mcp

# 启动服务（通过你定义的命令）
qnvip-mcp
```

### 方式2: 使用 uv run
```bash
# 直接运行，无需安装（需要先上传到 PyPI）
uv run --with qnvip-mcp -U qnvip-mcp

# 或者指定 PyPI 源
uv run --with qnvip-mcp -U qnvip-mcp  --index-url https://pypi.org/simple/
```

### 方式3: 在项目中使用
```bash
# 添加到项目依赖
uv add qnvip-mcp

# 运行
uv run qnvip-mcp
```

### 方式4：在 Cursor 中配置 MCP server
```json
{
  "mcpServers": {
    "qnvip-tools": {
      "command": "uv",
      "args": ["run", "--with", "qnvip-mcp", "-U", "qnvip-mcp", "--index-url", "https://pypi.org/simple/", "qnvip-mcp"],
      "env": {
        "DIFY_API_KEY": "app-xxx",
        "DIFY_API_URL": "https://xxx/v1/chat-messages",
        "PERSONAL_AUTHORIZATION": "qwen-xxx"
      }
    }
  }
}

```
env 配置
```dotenv
# 纯文本生成测试用例
DIFY_GEN_BY_TXT_API_URL=http://xxx/v1
DIFY_GEN_BY_TXT_API_KEY=app-xxx

# 带图片生成测试用例
DIFY_GEN_BY_IMG_API_URL=http://xxx.com/v1
DIFY_GEN_BY_IMG_API_KEY=app-xxx

# 文件上传服务地址
FILE_UPLOAD_URL=http://xxx
```