Skip to main content

Description

Convert your knowledge base website (or any page) into a text file that you can store as a vector in any of the existing vector databases. Uses AI browser automation to scrape and process web content.

The databases supported are:

  • Pinecone
  • ChromaDB
  • Milvus

Installation

pip install page2vec

Example Usage

Command Line Interface

After installation, you can use the page2vec command. All commands require an OpenAI API key for the LLM that browser automation agent uses.

Pinecone

Update all values with the ones from your account: API key, index name, namespace, etc.

page2vec \
  --database pinecone \
  --url "[INSERT A URL]"  \
  --openai-api-key "[YOUR OPENAI API KEY]"  \
  --pinecone-api-key "[YOUR PINECONE API KEY]"  \
  --pinecone-index "page2vec-testing" \
  --pinecone-namespace "page2vec-default"

ChromaDB

page2vec \
  --url "[INSERT A URL]"  \
  --database chromadb \
  --openai-api-key "[YOUR OPENAI API KEY]"  \
  --chromadb-api-key "[YOUR CHROMADB API KEY]"  \
  --chromadb-database-name "page2vec-testing"

Milvus

page2vec \
  --url "[INSERT A URL]"  \
  --database milvus \
  --openai-api-key "[YOUR OPENAI API KEY]"  \
  --milvus-output-file "milvus_data.db"  \
  --milvus-collection-name "page2vec-testing"

Custom prompt example

page2vec
--database pinecone
--url "[INSERT A URL]"
--openai-api-key "[YOUR OPENAI API KEY]"
--pinecone-api-key "[YOUR PINECONE API KEY]"
--pinecone-index "page2vec-testing"
--pinecone-namespace "page2vec-default" --custom-prompt "Find all the paragraphs of the documentation in https://docs.trychroma.com/docs/overview/contributing. Store only the first 3 paragraphs in a separate row in a CSV."

Python API

You can also use page2vec programmatically:

import asyncio
from page2vec import async_main
from argparse import Namespace

# Create arguments
args = Namespace(
    database="pinecone",
    url="https://docs.example.com",
    openai_api_key="your-openai-api-key",
    pinecone_api_key="your-pinecone-api-key",
    pinecone_index="your-index",
    pinecone_namespace="your-namespace",
    test_mode=False
)

# Run the process
asyncio.run(async_main(args))

Dependencies

This project uses:

  • browser-use: AI-powered browser automation for intelligent web scraping
  • Database SDKs: Pinecone, ChromaDB, and Milvus clients

Future Support

These databases will be supported in the future (or upon request):

  • PostgreSQL
  • Elasticsearch

Development Installation

If you'd like to debug something or contribute:

git clone <repository-url>
cd page2vec
pip install -e ".[dev]"

Metadata

Release files for page2vec 0.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for page2vec 0.1.0
File Size Uploaded
page2vec-0.1.0.tar.gz 126.6 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for page2vec 0.1.0
File Interpreter ABI Platform
page2vec-0.1.0-py3-none-any.whl Python 3 none any Details

Total release size: 135.8 kB

Release files / page2vec-0.1.0.tar.gz

Download URL page2vec-0.1.0.tar.gz
Size 126.6 kB
Tags Source
SHA-256 checksum
How to use checksums
049ca62ac552ca66a0a350431beed9584ab654faebc9b521a37a66eed3db06c0
BLAKE2b-256 checksum
How to use checksums
baa4b4a0abc18f6ad9df162bb44524d7460a1cc9310aadbdd954a183e30a8f38
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.11.3

Release files / page2vec-0.1.0-py3-none-any.whl

Download URL page2vec-0.1.0-py3-none-any.whl
Size 9.2 kB
Tags Python 3
SHA-256 checksum
How to use checksums
b5bd6fc825b6d45c5aa3aac7ee9d3920dddd3eae4ac58fdb7c958a6c389558cd
BLAKE2b-256 checksum
How to use checksums
b8058f950e733e81ff16c867375910c7c13d953eba685606c0f7c3556816c489
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.11.3

Release history Release notifications | RSS feed

This release

0.1.0 This release

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page