KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#developer-tools #codex #typescript #ai-agents #ai-agent #cli #claude-code #open-source #deepseek-harness #dsh-plugin #python #mcp

peersky-browser

★ 85 Open GitHub ↗

A peer-to-peer web browser

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

<h1 align="center">PeerSky Browser</h1>

💻 [Download](https://peersky.p2plabs.xyz/)

## Roadmap

- [x] Basic browser navigation:

- [x] Back
  - [x] Forward
  - [x] Reload
  - [x] Browser protocol (peersky://)
  - [x] Home page (peersky://home)
  - [x] Cross browser themeing ([browser://theme/](https://github.com/p2plabsxyz/peersky-browser/blob/main/docs/Theme.md))
  - [x] Search engine
    - DuckDuckGo (default)
    - Brave Search
    - Ecosia
    - Kagi
    - Startpage
  - [x] Tabs
    - Vertical tabs toggle

- [x] IPFS protocol handler:

- [x] Run a local [Helia](https://helia.io/) node
  - [x] `ipfs://` / `ipns://` native URLs support
  - [x] Directory listings support
  - [x] Native ENS domain resolution:
    - [x] Resolve `.eth` domains directly to IPFS/IPNS content without centralized gateways (e.g., `ipfs://vitalik.eth`).
    - [x] Local caching for resolved ENS content to enhance performance and reduce RPC calls.

- [x] Hypercore protocol handler:

- [x] Run a local [hyper](https://holepunch.to/) node
  - [x] `hyper://` native URLs support

- [x] BitTorrent protocol handler:

- [x] [WebTorrent](https://webtorrent.io/) in isolated child process
  - [x] `bittorrent://` / `bt://` / `magnet:` native URLs support
  - [x] Real-time download progress UI with pause/resume
  - [x] Auto-destroy torrent on completion (no seeding)
  - [x] Optional `bt://` seeding

- [x] Local `file://` browsing with P2P publishing:
  - [x] Custom `file://` support with privileged access
  - [x] Directory listings (Chrome-style)
  - [x] One-click P2P publishing to:
      - [x] IPFS (`ipfs://`)
      - [x] Hypercore (`hyper://`)

- [x] Web3 protocol handler:

- [x] Run a local [web3 protocol](https://docs.web3url.io/) node
    - [x] Access on-chain websites.
    - [x] Fetch data from smart contracts using auto, manual, and resource request resolve modes.
    - [x] Query account balances or other data directly from smart contracts.

- [x] P2P Applications:

- [x] `peersky://p2p/peerchat/`
    - Peer-to-peer messaging over Hyper
  - [x] `peersky://p2p/upload/`
    - Decentralized file storage
  - [x] `peersky://p2p/peerpad/`
    - Build and publish websites
  - [x] `peersky://p2p/p2pmd/`
    - Real-time collaborative markdown editor
    - Presentation slides mode with speaker notes
    - Offline KaTeX math mode with inline scientific templates
    - IEEE-style two-column research paper preview/export
    - AI-powered content generation
    - Publish to IPFS/Hypercore
    - Peers dashboard with roles, live editing status, and edit history
  - [x] `peersky://p2p/wiki/`
    - Browse Wikipedia over IPFS
  - [x] [reader.p2plabs.xyz](https://reader.distributed.press/)
    - A p2p offline ActivityPub client for reading and following microblogs on the fediverse.

- [x] Electron’s Auto-updater:

- [x] Download and install the latest release from Github automatically

- [x] Context menu:

- [x] Back / Forward
  - [x] Reload
  - [x] Inspect
  - [x] Undo / Redo
  - [x] Cut / Copy / Paste
  - [x] Copy Link Address
  - [x] Open Link in New Tab

- [x] Find in page:
  - [x] Search for text within a document or web page

- [x] Window state persistence:
  - [x] Save and restore open windows on app launch

- [x] Keyboard shortcuts:

- [x] New Window: `CommandOrControl+N`
  - [x] Back: `CommandOrControl+[`
  - [x] Forward: `CommandOrControl+]`
  - [x] Reload: `CommandOrControl+R`
  - [x] Find in Page: `CommandOrControl+F`
  - [x] Open Dev Tools: `CommandOrControl+Shift+I`
  - [x] Focus URL Bar: `CommandOrControl+L`
  - [x] Minimize: `CommandOrControl+M`
  - [x] Close: `CommandOrControl+W`
  - [x] Toggle Full Screen: `F11`

- [x] Settings (peersky://settings):

- [x] Switch search engines
  - [x] Set custom home page wallpapers
  - [x] Hide/show the home page clock
  - [x] Change themes
  - [x] Clear browser cache

- [x] [Local LLM](https://github.com/p2plabsxyz/peersky-browser/blob/main/docs/LLM.md) integration for P2P apps:
  - [x] `window.llm` APIs (chat + streaming, complete)
  - [x] Trusted-domain exposure (PeerSky-native + allowlist)
  - [x] AI Chat app (peersky://p2p/ai-chat/)
    - [x] Ported from [Agregore examples](https://github.com/AgregoreWeb/website/blob/main/docs/examples/llm-chat.html) with PeerSky updates
  - [x] P2P Editor integration (peersky://p2p/peerpad/)
    - [x] New AI generator (`ai-generator.js`) to generate code with AI

- [x] [LLM Memory](https://github.com/p2plabsxyz/peersky-browser/issues/97)
    - [x] `llm.json` to store prompts/responses across P2P apps
    - [x] Reusable History component (P2P editor, AI chat, etc.)
    - [x] Settings toggle to enable/disable memory
    - [x] “Reset P2P Data” also clears `llm.json`

- [x] [Web extensions](https://github.com/p2plabsxyz/peersky-browser/issues/19):
  - [x] Ability to add and manage extensions
  - [x] [Default extensions](https://github.com/p2plabsxyz/essential-chromium-extensions)
  - [ ] 🚧 [Decentralized Extension Distribution](https://github.com/p2plabsxyz/peersky-browser/issues/42)

- [x] Bookmarks (peersky://bookmarks):

- [x] Option to add favourite pages in the nav bar (peersky://bookmarks)

- [x] QR Code generator:

- [x] Option to generate QR Code for every page in the URL prompt with [plan1](./docs/Plan1.md).

- [x] Archive (peersky://archive):

- [x] List and showcase published content from `peersky://p2p/` apps for enhanced discoverability.
  - [x] Provide metadata (e.g., creation date, content type) to improve navigation and usability.
  - [x] Ability to download all the hashes of published data in a .json file.

## Development

### Node.js and npm Setup

Please refer to the [Node.js official documentation](https://nodejs.org/) to install Node.js. Once installed, npm (Node Package Manager) will be available, allowing you to run commands like `npx` and `npm`.

- **npm**: Comes bundled with Node.js. Verify installation by running:
  ```bash
  node -v
  npm -v
  ```

### Install dependencies

```bash
npm install
```

### Start the app

```bash
npm start
```

### Build
  After development of the browser, run the following command. This will create a production build.

```bash
npm run build
# For Intel and Silicon macs
```

```bash
npm run build-all
# For macOS, Linux, and Windows
```

Now, the `dist` folder will appear in the root directory.

### Linting

This project uses [StandardJS](https://standardjs.com) for code style. To check for lint errors:

```bash
npm run lint
```

To auto-fix lint errors:

```bash
npx standard --fix
```

### Testing

Run all tests:

```bash
npm test
```

Run specific test suites:

```bash
npm run test:p2p          # Unit tests (IPFS/Hyper handlers)
npm run test:p2p:e2e      # End-to-end sync tests (2-3 min)
npm run test:extensions   # Extension lifecycle tests
npm run test:security     # Security and isolation tests
npm run test:integration  # Real app restart tests (5+ min)
```

For detailed testing documentation, see [Testing Guide](./docs/Testing.md).

### Logging

For details on the Peersky logging system, see the [Logging Documentation](./docs/Logging.md).

## Contribute

- Thanks for your interest in contributing to PeerSky Browser. There are many ways you can contribute to the project.
- To start, take a few minutes to read the "[contribution guide](https://github.com/p2plabsxyz/peersky-browser/blob/main/.github/CONTRIBUTING.md)".
- We look forward to your [pull requests](https://github.com/p2plabsxyz/peersky-browser/pulls) and / or involvement in our [issues page](https://github.com/p2plabsxyz/peersky-browser/issues).

## License

PeerSky Browser is licensed under the [MIT License](https://github.com/p2plabsxyz/peersky-browser/blob/main/LICENSE).

peersky-browser

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README