semvec/pypi-packages huggingface dataset:
NLPsych 0.1.3
Tools for text analysis, embeddings, and lightweight modeling with a Streamlit app interface.
License: MIT
Requires Python: >=3.9

<p align="center">
  <img src="https://raw.githubusercontent.com/shwnmnl/NLPsych/main/assets/NLPsych_logo.png" alt="NLPsych logo" width="150"/>
</p>

<h1 align="center">NLPsych</h1>

NLPsych (*Natural Language Psychometrics*) lets you upload a CSV file, pick your text columns, and get instant descriptive statistics, visualize semantic embeddings, and run predictive models all in one streamlined workflow.

## ⚙️ Features
- 📊 Descriptive statistics: word counts, sentence lengths, lexical diversity
- 🔎 Embeddings: Sentence-Transformers + dimensionality reduction (PCA, UMAP, t-SNE)
- 🤖 Modeling: Quick logistic regression / ridge regression with cross-validation + permutation tests
- 📑 Reports: Auto-generated HTML/Markdown reports with interpretations

💡 Tip: If you only need the functions, install via pip. If you want the interactive app, clone the repo and run it with Streamlit.

## 📦 Installation (library only)

To use NLPsych functions in your own Python code:

```bash
pip install NLPsych
```

## 🚀 Running the app locally
```bash
pip install "NLPsych[app]"
nlpsych-app
```

## 🛠 Example Usage (library)
```python
import pandas as pd
from nlpsych.descriptive_stats import spacy_descriptive_stats
from nlpsych.embedding import embed_text_columns_simple_base, reduce_embeddings

df = pd.DataFrame({"text": [
    "Hello world. This is a tiny test.",
    "Patient denies chest pain. Vitals stable."
]})

stats_df, overall = spacy_descriptive_stats(df["text"])
print(overall["lexical_diversity"])

meta_df, emb, texts = embed_text_columns_simple_base([df["text"]])
Z = reduce_embeddings(emb, method="pca", n_components=2)
````

## 📂 Project structure

```
root/
├── .devcontainer/
├── .streamlit/   
│   └── config.toml
├── assets/    
│   └── NLPsych_logo.png          
├── src/
│   ├── nlpsych     
│   │   ├── __init__.py
│   │   ├── descriptive_stats.py
│   │   ├── embedding.py
│   │   ├── modeling.py
│   │   ├── report.py
│   │   └── utils.py
│   ├── nlpsych_app/              
│   │   ├── assets/    
│   │   │   └── NLPsych_logo.png          
│   │   ├── __init__.py
│   │   ├── app.py
│   │   └── launch.py
└── tests/              
````

## 🖋 License

MIT License © 2025 Shawn Manuel

## 👇 Contributing

PRs are welcome! If you have feature ideas or bug fixes, feel free to open an issue or submit a pull request.
zpp-beta 0.1.4
ZPP: Zero-hassle C++ build/run, metrics, and optimization hints with a real-time terminal UI
License: MIT
Requires Python: <3.13,>=3.10
Keywords: benchmark, c++, cli, developer-tools, g++, optimization, textual

### ZPP

Fast C++ build/run, metrics, and optimization hints with a real-time terminal UI.

[CI badge](https://github.com/yourname/zpp/actions)

### Quickstart

```bash
pipx install zpp-beta  # or: pip install --user zpp-beta
zpp init
zpp main.cpp      # build + run
zpp ui main.cpp   # open two-pane UI
```

### Features
- Build/run defaults: `-std=c++17 -O2 -pipe -Wall -Wextra`
- Two-pane Textual UI: left code, right metrics and hints
- Rule-based hints (offline) + optional AI hints
- Bench and mem commands for performance
- Auto-install guidance for g++/clang++ on Linux/macOS/Windows

### CLI

- `zpp <file.cpp>`: build + run quickly
- `zpp build <file.cpp> [--release] [--debug] [--flags "..."]`
- `zpp run [binary | file.cpp] [--args "..."]`
- `zpp bench <file.cpp> [--repeat 10]`
- `zpp mem <file.cpp>`
- `zpp hint <file.cpp> [--ai]`
- `zpp ui <file.cpp>`
- `zpp doctor`
- `zpp install-gpp [--dry-run] [--yes]`
- `zpp init`
- `zpp config`
- `zpp selfcheck`

### Auto-update for clients

If installed via pipx:
```bash
pipx upgrade zpp-beta
```

Or use the built-in command:
```bash
zpp self-update
```

Admins can point to TestPyPI for canary:
```bash
zpp self-update --index-url https://test.pypi.org/simple/
```

### Release process

- Push to `main` publishes to TestPyPI automatically.
- Tag a release `vX.Y.Z` to publish to PyPI.

### Snippets (Hints)

Before:
```cpp
vector<int> a;
for (int i=0;i<n;i++) a.push_back(i);
```
After:
```cpp
vector<int> a;
a.reserve(n);
for (int i=0;i<n;i++) a.push_back(i);
```

Before:
```cpp
void f(std::string s);
```
After:
```cpp
void f(const std::string& s); // or std::string_view
```

Before:
```cpp
for(...) y += pow(x, 2);
```
After:
```cpp
y += x * x;
```

### Packaging

- `pyproject.toml` exposes `zpp` entrypoint
- Optional single-binary via PyInstaller

### License

MIT
zpp-cli 0.1.3
ZPP: Zero-hassle C++ build/run, metrics, and optimization hints with a real-time terminal UI
License: MIT
Requires Python: <3.13,>=3.10
Keywords: benchmark, c++, cli, developer-tools, g++, optimization, textual

### ZPP

Fast C++ build/run, metrics, and optimization hints with a real-time terminal UI.

[CI badge](https://github.com/yourname/zpp/actions)

### Quickstart

```bash
pipx install zpp-cli  # or: pip install --user zpp-cli
zpp init
zpp main.cpp      # build + run
zpp ui main.cpp   # open two-pane UI
```

### Features
- Build/run defaults: `-std=c++17 -O2 -pipe -Wall -Wextra`
- Two-pane Textual UI: left code, right metrics and hints
- Rule-based hints (offline) + optional AI hints
- Bench and mem commands for performance
- Auto-install guidance for g++/clang++ on Linux/macOS/Windows

### CLI

- `zpp <file.cpp>`: build + run quickly
- `zpp build <file.cpp> [--release] [--debug] [--flags "..."]`
- `zpp run [binary | file.cpp] [--args "..."]`
- `zpp bench <file.cpp> [--repeat 10]`
- `zpp mem <file.cpp>`
- `zpp hint <file.cpp> [--ai]`
- `zpp ui <file.cpp>`
- `zpp doctor`
- `zpp install-gpp [--dry-run] [--yes]`
- `zpp init`
- `zpp config`
- `zpp selfcheck`

### Auto-update for clients

If installed via pipx:
```bash
pipx upgrade zpp-cli
```

Or use the built-in command:
```bash
zpp self-update
```

Admins can point to TestPyPI for canary:
```bash
zpp self-update --index-url https://test.pypi.org/simple/
```

### Release process

- Push to `main` publishes to TestPyPI automatically.
- Tag a release `vX.Y.Z` to publish to PyPI.

### Snippets (Hints)

Before:
```cpp
vector<int> a;
for (int i=0;i<n;i++) a.push_back(i);
```
After:
```cpp
vector<int> a;
a.reserve(n);
for (int i=0;i<n;i++) a.push_back(i);
```

Before:
```cpp
void f(std::string s);
```
After:
```cpp
void f(const std::string& s); // or std::string_view
```

Before:
```cpp
for(...) y += pow(x, 2);
```
After:
```cpp
y += x * x;
```

### Packaging

- `pyproject.toml` exposes `zpp` entrypoint
- Optional single-binary via PyInstaller

### License

MIT