https://github.com/cijiugechu/persona-http
A blazing-fast HTTP client with TLS fingerprinting for Node.js
https://github.com/cijiugechu/persona-http
client fingerprint http napi-rs tls-fingerprinting
Last synced: 9 months ago
JSON representation
A blazing-fast HTTP client with TLS fingerprinting for Node.js
- Host: GitHub
- URL: https://github.com/cijiugechu/persona-http
- Owner: cijiugechu
- License: mit
- Created: 2025-10-01T15:07:56.000Z (9 months ago)
- Default Branch: main
- Last Pushed: 2025-10-05T08:01:58.000Z (9 months ago)
- Last Synced: 2025-10-05T08:33:23.511Z (9 months ago)
- Topics: client, fingerprint, http, napi-rs, tls-fingerprinting
- Language: Rust
- Homepage:
- Size: 192 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Agents: AGENTS.md
Awesome Lists containing this project
README
# persona-http
A blazing-fast HTTP client with TLS fingerprinting for Node.js. Native Rust bindings via napi-rs.
Based on [rnet](https://github.com/0x676e67/rnet) - the original Python implementation.
## Installation
```bash
npm install persona-http
```
## Usage
### Simple GET request
```typescript
import { get } from 'persona-http'
const response = await get('https://example.com')
const body = await response.text()
```
### Client with browser emulation
```typescript
import { Client } from 'persona-http'
const client = new Client({
emulation: 'chrome_133',
})
const response = await client.get('https://google.com')
const body = await response.text()
```
### Override emulation per request
```typescript
const client = new Client({ emulation: 'chrome_105' })
// Override with different preset
const response = await client.get(url, { emulation: 'chrome_101' })
// Skip client hint headers
const response2 = await client.get(url, {
emulation: { preset: 'chrome_105', skipHeaders: true },
})
```
## Platform Support
| Platform | Architectures | Node.js |
| ------------- | --------------- | ------- |
| macOS | x64, arm64 | 20, 22 |
| Windows | x64, x86, arm64 | 20, 22 |
| Linux (glibc) | x64, arm64 | 20, 22 |
| Linux (musl) | x64, arm64 | 20, 22 |
| FreeBSD | x64 | 20, 22 |
| Android | arm64, armv7 | - |
## Development
Requirements:
- Rust (latest stable)
- Node.js 20+
- pnpm
Build and test:
```bash
pnpm install
pnpm build
pnpm test
```
## License
MIT