The LBRY SDK for building decentralized, censorship resistant, monetized, digital content apps.
Find a file
2019-05-01 13:16:32 -03:00
.github Update PULL_REQUEST_TEMPLATE.md 2018-11-27 15:38:06 -05:00
docs regenerated docs 2019-04-29 09:49:39 -04:00
icons icons! 2018-11-29 17:15:18 -05:00
lbrynet small adjustment to new_peer_or_finished 2019-05-01 02:55:51 -03:00
scripts dropped block_show command from API, users should run a full node if they need access to blocks 2019-04-27 18:03:35 -04:00
tests test get-delete-get respects existing files 2019-05-01 13:16:32 -03:00
.dockerignore orchstr8 docker for lbry 2019-01-15 17:15:24 -05:00
.gitattributes use union merge on CHANGELOG.md 2017-02-20 21:37:50 -06:00
.gitignore exposed new protobuf fields in APIs and updated tests 2019-04-21 00:45:51 -04:00
.pylintrc remove unused packages from extension-pkg-whitelist in pylintrc 2019-02-03 15:02:43 -05:00
.travis.yml make sure to use python3 when running set_build.py 2019-04-21 16:31:46 -04:00
CHANGELOG.md 0.30.1 changelog updates 2018-12-09 23:30:09 -05:00
CONTRIBUTING.md Update CONTRIBUTING.md 2019-04-01 16:12:49 -04:00
Dangerfile fix because the danger.systems code example was wrong 2017-02-07 23:08:35 -06:00
example_daemon_settings.yml rename streaming_only setting -> save_files 2019-04-24 12:44:12 -04:00
INSTALL.md Update python3 > python, add mac instructions 2019-04-06 17:10:32 -04:00
lbry.png Remove icons directory (#1389) 2018-08-24 17:36:52 -04:00
LICENSE Update LICENSE 2019-02-14 08:47:26 -05:00
mkdocs.yml added more social links 2018-11-18 10:29:47 -05:00
README.md Update README.md 2019-04-01 16:12:49 -04:00
setup.py Fixes incompatible attrs issue when running pip install -e . 2019-04-06 18:43:34 -04:00
tox.ini all 2019-03-25 22:54:08 -04:00

LBRY LBRY SDK Build Status Test Coverage

LBRY is a decentralized peer-to-peer protocol for publishing and accessing digital content. It utilizes the LBRY blockchain as a global namespace and database of digital content. Blockchain entries contain searchable content metadata, identities, rights and access rules. LBRY also provides a data network that consists of peers (seeders) uploading and downloading data from other peers, possibly in exchange for payments, as well as a distributed hash table used by peers to discover other peers.

LBRY SDK for Python is currently the most full featured implementation of the LBRY Network protocols and includes many useful components and tools for building decentralized applications. Primary features and components:

  • Built on Python 3.7+ and asyncio.
  • Kademlia DHT (Distributed Hash Table) implementation for finding peers to download from and announcing to peers what we have to host (lbrynet.dht).
  • Blob exchange protocol for transferring encrypted blobs of content and negotiating payments (lbrynet.blob_exchange).
  • Protobuf schema for encoding and decoding metadata stored on the blockchain (lbrynet.schema).
  • Wallet implementation for the LBRY blockchain (lbrynet.wallet).
  • Daemon with a JSON-RPC API to ease building end user applications in any language and for automating various tasks (lbrynet.extras.daemon).

Installation

Our releases page contains pre-built binaries of the latest release, pre-releases, and past releases for macOS, Debian-based Linux, and Windows. Automated travis builds are also available for testing.

Usage

Run lbrynet start to launch the API server.

By default, lbrynet will provide a JSON-RPC server at http://localhost:5279. It is easy to interact with via cURL or sane programming languages.

Our quickstart guide provides a simple walkthrough and examples for learning.

With the daemon running, lbrynet commands will show you a list of commands.

The full API is documented here.

Running from source

Installing from source is also relatively painless. Full instructions are in INSTALL.md

Contributing

Contributions to this project are welcome, encouraged, and compensated. For more details, please check this link.

License

This project is MIT licensed. For the full license, see LICENSE.

Security

We take security seriously. Please contact security@lbry.com regarding any security issues. Our GPG key is here if you need it.

Contact

The primary contact for this project is @eukreign.

The documentation for the API can be found here.

Daemon defaults, ports, and other settings are documented here.

Settings can be configured using a daemon-settings.yml file. An example can be found here.