Skip to main content

Zylo-docs seamlessly integrates with FastAPI to automatically generate OpenAPI-compliant specs—so you can write your API docs faster and go home early.

Project description

zylo-docs
Build the world’s best API docs highly integrated with FastAPI for developers

Supported Python versions


Writing technical documentation like API specs is often a burden for software engineers — it’s not their expertise, and rarely a top priority. That’s where Zylo-docs comes in. Zylo-docs seamlessly integrates with FastAPI and automatically generates OpenAPI-compliant specs. With powerful AI assistance, it helps developers create clear, user-friendly, and rich documentation with minimal effort. Think of it as a more intuitive, AI-powered alternative to Swagger.

[1/7] Get Started (Add boilerplate code)

from fastapi import FastAPI
# 👇 [1/2] Add this import at the top
from zylo_docs import zylo_docs

app = FastAPI()

@app.get("/")
async def read_root():
    return {"message": "Hello, FastAPI!"}

...
...
...

# 👇 [2/2] Add this at the bottom of your entry point file (e.g., main.py)
zylo_docs(app)

[2/7] Run the FastAPI Server

uvicorn main:app --reload

You need to start the server using Uvicorn.

⚡️ If your server is already running, you can skip this step.

Once the server is running, open your browser and go to: 👉 http://localhost:8000/zylo-docs
(⚠️ If your development server runs on a different port, update the URL accordingly!)

[3/7] Tada! You can now view beautifully structured API specs with zylo-docs.

3:7

[4/7] To use Zylo AI, sign up and sign in to zylo.

u-4

To enhance your documentation with AI, please sign in to zylo-docs.

[5/7] Use the Zylo AI function to upgrade your docs

5:7

[6/7] Tada! Look at the red dot in the top-left corner! It is completed. Let's check this out!

6:7 After you find the red dot on the version selector, it means that our API specs are now upgraded and more user-friendly with zylo-docs. you can find the lastest one. Once you click it, you can check the new one filled with rich content.

[6.2/7] You can compare generated docs with privious one.

https://github.com/user-attachments/assets/58370b53-d98c-4cb5-8cd3-b628dd48c1e9

[6.5/7] You can also regenerate specific parts of the data, such as test cases.

https://github.com/user-attachments/assets/34a0eee7-364e-4572-9930-440c00db7085

[7/7] Share your API docs with your team

7:7

Click the Publish button to share your API documentation via email.

Development

  • Python 3.10+
  • FastAPI, Uvicorn

License

MIT License

Project details


Release history Release notifications | RSS feed

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

zylib_test-0.0.134.tar.gz (273.1 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

zylib_test-0.0.134-py3-none-any.whl (278.4 kB view details)

Uploaded Python 3

File details

Details for the file zylib_test-0.0.134.tar.gz.

File metadata

  • Download URL: zylib_test-0.0.134.tar.gz
  • Upload date:
  • Size: 273.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.12.3

File hashes

Hashes for zylib_test-0.0.134.tar.gz
Algorithm Hash digest
SHA256 e15f15101d86d57cb8a9d7b5017cce42793f6b00f297594a1f7dd1ee94b942c2
MD5 c2037f61fbb0d7eaffaff908be0e8eba
BLAKE2b-256 ef1a19e778eff25523cf827b9b7e4d3737b8756a3d9e3986ac9535fe86b41f7c

See more details on using hashes here.

File details

Details for the file zylib_test-0.0.134-py3-none-any.whl.

File metadata

  • Download URL: zylib_test-0.0.134-py3-none-any.whl
  • Upload date:
  • Size: 278.4 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.12.3

File hashes

Hashes for zylib_test-0.0.134-py3-none-any.whl
Algorithm Hash digest
SHA256 995e48041739a5c26f55cac006597b8c68196a65c7e2ad12f966bb8f2f20f1e2
MD5 3d4a9fdbed5b3c7e75bf035fccd9a62f
BLAKE2b-256 da5f9f0b2ba050e8f6c04222504cfa4c19d6b80cbf2acc9923d45f8f4e285a89

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page