KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

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

SDCN-Stable-Diffusion-Computing-Network

★ 31 Open GitHub ↗

SDCN is an infrastructure that allows people to share and use Stable Diffusion computing power easily.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

<a href="https://www.sdcn.info" target="_blank">Website</a> |
 <a href="https://www.sdcn.info/play" target="_blank">Playground</a> |
 <a href="https://docs.sdcn.info">API Docs</a>

## Overview

**[SDCN](https://www.sdcn.info) is an infrastructure for sharing Stable Diffusion computing power**

- **Decentralization**: By running the SDCN node program, users can register their idle computing resources with the SDCN network
- **Trustlessness**: SDCN abstracts the capabilities of Stable Diffusion into a set of atomic interface calls and hides the computing process from application developers
- **Powerful**: Application developers can quickly develop their own applications based on the Stable Diffusion related capabilities provided by SDCN, without worrying about how these interfaces are implemented or how computing power is provided

![SDCN structure](https://raw.githubusercontent.com/fiatrete/SDCN-Stable-Diffusion-Computing-Network/main/imgs/dan_structure_image.png)

- SDCN Node
  - Executes image generation tasks
  - Use Stable Diffusion WebUI with API mode directly
- SDCN Server
  - Manage and route image generation tasks to SDCN Nodes
  - Hide the image generating details and expose a standard interface to application developers
  - Implement SDCN server with openresty
- API
  - txt2img
  - img2img
  - integrate
  - more APIs under developing

**Why SDCN?**

- Everyone should have the ability to use AI freely, AI will be a public good
- For the public, the cost of trying various ways of stable diffusion is too high
    - It's difficult to set up a stable diffusion runtime environment on your own
    - Computer performance may not support it
    - Downloading code from GitHub and running Stable Diffusion WebUI is beyond the ability of most non-programmers(even programmers)
    - Learning about models and prompt knowledge requires high learning costs
- More application developers should be supported in popularizing AI capabilities to the public
- For application developers, the cost of building a publicly available image generation service is too high
    - Application developers should focus on implementing business requirements
- The utilization of GPU computing power for home and cloud procurement is very low, leading to significant wastage

## Getting Started

Try out SDCN functionalities in [SDCN website](https://www.sdcn.info/).

🎈Feel free to file tickets for bugs or feature requests.

## 📱 How-to: try out SDCN API

SDCN provide SaaS-like API from [https://api.sdcn.info](https://api.sdcn.info)

### Using `dan_run.py` script

Try the sample code in `example` folder.

You can modify the `example/params-xxx.json` to experiment with different parameter combinations.

```bash
python3 dan_run.py txt2img params-txt2img.json OUTPUT_IMAGE.png
python3 dan_run.py img2img params-img2img.json ORIGINAL_IMAGE.png OUTPUT_IMAGE.png
```

### Using `curl`
1. Install `curl` and `jq`
```bash
brew install curl jq
```
2. Enter `example` folder and execute
```bash
cd example
cat params-txt2img.json \
| curl --location --request POST 'https://api.sdcn.info/api/sd/txt2img' \
--header 'Content-Type: application/json' -d @- \
| jq '.data.images[0]' |tr -d '\"' | tr -d '\\' | base64 -d > out.png
```

👉 **SDCN API** refer to [API Docs](doc/api.md)

## 🌐 How-to: contribute computing power to sdcn.info

1. Register a `donor account` on [sdcn.info](https://www.sdcn.info/) 
2. Install lastest [Stable Diffusion WebUI](https://github.com/AUTOMATIC1111/stable-diffusion-webui) on your PC or Server
3. Start according to README.md in the dan-node file

## 🔨 How-to: run dan-server locally in Docker

1. Install lastest [Stable Diffusion WebUI](https://github.com/AUTOMATIC1111/stable-diffusion-webui) and [Docker](https://github.com/jenkinsci/docker) on your PC or Server

2. Register a `donor account` on [sdcn.info](https://www.sdcn.info/)

3. Start according to README.md in the dan-node file

4. Register a new github OAuth Application set callback url: http://localhost:6006/api/user/connect/github. Get the github client ID and SECRET:, then set in the docker-compose.yml.

5. Start dan-server locally in docker with [Docker Compose](https://github.com/docker/compose):
```
docker-compose up -d 
```

>*Now your dan-server is available on "[http://127.0.0.1:6006](http://127.0.0.1:6006/)"*

6. Register your Stable Diffusion WebUI instance as a SDCN node:

- Login your account using SDCN's web page: http://127.0.0.1:6006;
- Navigate to `Nodes` -> `Donate Node`
- Enter your worker node's address
- Click `Donate`

> ⚠️ *Please note that you must use non-loopback IP address in your node's address! You cannot use 127.0.0.1 or 'localhost' since our docker container's `hostnet` is not enabled.*

7. Config SERVICE_PREFIX in `example/dan_run.py` to "[http://127.0.0.1:6006](http://127.0.0.1:6006/)".

```python
SERVICE_PREFIX = 'http://127.0.0.1:6006'
```

8. Execute the example with your local dan-server:

```bash
python3 dan_run.py txt2img params-txt2img.json OUTPUT_IMAGE.png
```

## Roadmap

- [x] Rename project to SDCN
- [x] Management GUI for computing power donors
    - [x] Add login to the SDCN website
    - [x] CRUD management of computing power provided by donors
- [x] Workload ranking page
    - [x] Node-based workload ranking
    - [x] Donor-based workload ranking
    - [ ] Model-based workload ranking
    - [ ] API-based workload ranking
- [ ] Basic SDCN functional interfaces
    - [ ] Scale interface
    - [x] Inpaint interface
    - [x] Support for controlnet
- [ ] Enrich examples in the playground
    - [ ] 2D to 3D style conversion
    - [ ] 3D to 2D style conversion
- [x] One-click installation of Stable Diffusion WebUI as an SDCN node (Windows & Linux supported)
    - [x] Customize Stable Diffusion WebUI installer
    - [x] Automatically download necessary model files
    - [x] Customize SDCN node daemon as intermediary for communication between Stable Diffusion WebUI and SDCN server
- [ ] Image Stream (user generated by the SDCN tool and share to sdcn.info)
    - [ ] Sharing mechanisms for images generated through API or playground
    - [ ] A page to display shared images in a waterfall flow
- [x] Constraints for the use of computing resources
    - [x] API-Key mechanism
    - [x] honor(credit) system
- [ ] Task scheduling mechanism
    - [ ] Schedule to nodes with required models already loaded
    - [ ] Global load balancing

## License

This project is licensed under the [MIT license]

[MIT license]: https://github.com/fiatrete/SDCN-Stable-Diffusion-Computing-Network/blob/main/LICENSE

## Credits

- Stable Diffusion - https://github.com/CompVis/stable-diffusion
- Stable Diffusion web UI - https://github.com/AUTOMATIC1111/stable-diffusion-webui
- Ant Design - https://github.com/ant-design/ant-design

SDCN-Stable-Diffusion-Computing-Network

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README