captura de pantalla 2026 01 29 132047

Software Documentation

This project is fully open-source. The code is publicly available, documented, and maintained in the official GitHub repository.

View GitHub Repository

Project Resources

Access the main software materials, source code, fuzzy color space repositories and demonstration resources.

Download & Installation

Standalone executable version of PyFCS

A standalone executable version of PyFCS is available for download. This package includes the graphical user interface and the required dependencies, allowing the application to be launched without additional configuration.

The executable package is currently provided for Windows systems.
Latest version PyFCS v1.4.0

Desktop GUI executable package.

Download PyFCS v1.4.0 Open repository
Source Code

Source code and installation from GitHub

PyFCS is publicly available as open-source software on GitHub. The repository provides access to the full source code, demonstration materials, and additional utility files.

Open GitHub repository pip installation guide

System Requirements

Before installing PyFCS, ensure that a Python environment is properly configured.

  • Python 3.9 or higher is required. Python 3.10 is recommended.
  • The commands python and pip must be available from the command line.
  • A virtual environment manager, such as venv or Anaconda, is recommended but not required.

If the pip command is not available, it can be installed using: 

python -m ensurepip --upgrade

Installation

Windows
  1. Download the project from GitHub using the Clone or Download option, or download the .zip file from the releases section.
  2. Extract the archive to a local directory.
  3. Open Command Prompt or PowerShell, navigate to the project root directory, and install the required dependencies: 
pip install -r PyFCS\external\requirements.txt

Launch the graphical interface by executing: 

python PyFCS\interface\mainInterface.py
Linux
  1. Download and extract the project from GitHub.
  2. Open a terminal and navigate to the project root directory.
  3. Make the setup script executable. This is only required once:
chmod +x ./PyFCS/external/setup_pyfcs_linux.sh

Run the setup script: 

./PyFCS/external/setup_pyfcs_linux.sh
The script automatically creates and activates a virtual environment, installs Python dependencies, and checks or installs system-level requirements such as Tkinter. Administrator permissions may be required.
macOS
  1. Download and extract the project from GitHub.
  2. Open the Terminal and navigate to the project root directory.
  3. Make the setup script executable. This is only required once:
chmod +x ./PyFCS/external/setup_pyfcs_mac.sh

Run the setup script: 

./PyFCS/external/setup_pyfcs_mac.sh
The script automatically installs Python via Homebrew, sets up a virtual environment, installs dependencies, and verifies Tkinter. Make sure Homebrew and the Xcode Command Line Tools are installed.
Repository of Fuzzy Color Spaces

Downloadable fuzzy color spaces and color naming systems

This section provides a shared repository of fuzzy color spaces and color naming systems available for download and reuse by researchers and practitioners in color modeling.

Fuzzy color spaces are distributed as .fcs files, a structured text-based format designed to store collections of fuzzy colors, including their linguistic labels, representative values, membership functions and associated surface definitions.

Color naming system files with extension .cns are also provided. These files contain sets of color names and their representative values, which can serve as positive prototypes for the construction of new fuzzy color spaces.

Fuzzy Color Spaces

Ready-to-use .fcs files for visualization, analysis and application in PyFCS.

.fcs ISCC_NBS_BASIC

13 colors

Download .fcs BRUGUER-ACRYLIC

62 colors

Download .fcs ISCC_NBS_EXTENDED

20 colors

Download .fcs BRUGUER-VIBRATIONS

36 colors

Download .fcs ISCC_NBS_COMPLETE

267 colors

Download .fcs BRUGUER-WORLD COLORS

54 colors

Download

Color Naming Systems

Labels and representative values distributed as .cns files. Select a color naming system to preview its representative colors and download the corresponding file.

Preview
ISCC_NBS_BASIC

13 representative colors.

Download .cns
Color RGB Values Label
254, 181, 186Pink
200, 1, 25Red
243, 132, 1Orange
138, 40, 27Brown
243, 195, 1Yellow
102, 93, 30Olive
141, 182, 1Yellow-Green
1, 98, 45Green
1, 103, 194Blue
154, 78, 174Purple
252, 252, 249White
135, 134, 134Gray
7, 7, 7Black
Preview
ISCC_NBS_EXTENDED

20 representative colors.

Download .cns
Color RGB Values Label
254, 181, 186Pink
200, 1, 25Red
243, 132, 1Orange
138, 40, 27Brown
243, 195, 1Yellow
102, 93, 30Olive
141, 182, 1Yellow-Green
1, 98, 45Green
1, 103, 194Blue
154, 78, 174Purple
252, 252, 249White
135, 134, 134Gray
7, 7, 7Black
107, 142, 35Yellow-Olive
0, 191, 255Sky Blue
255, 20, 147Deep Pink
160, 82, 45Sienna
255, 228, 196Bisque
72, 61, 139Slate Blue
210, 105, 30Chocolate
Preview
ISCC_NBS_COMPLETE

267 representative colors.

Download .cns
Color RGB Values Label
57, 12, 140Color 1
125, 114, 71Color 2
52, 44, 216Color 3
16, 15, 47Color 4
111, 119, 13Color 5
101, 214, 112Color 6
229, 142, 3Color 7
81, 216, 174Color 8
142, 79, 110Color 9
172, 52, 47Color 10
194, 49, 183Color 11
176, 135, 22Color 12
235, 63, 193Color 13
40, 150, 185Color 14
98, 35, 23Color 15
116, 148, 40Color 16
119, 51, 194Color 17
142, 232, 186Color 18
83, 189, 181Color 19
107, 136, 36Color 20
4, 153, 53Color 91
68, 135, 59Color 92
54, 79, 139Color 93
144, 107, 175Color 94
104, 135, 250Color 95
128, 26, 47Color 96
216, 141, 22Color 97
1, 170, 66Color 98
134, 82, 226Color 99
218, 4, 57Color 100
38, 76, 18Color 101
189, 75, 220Color 102
65, 21, 157Color 103
186, 20, 183Color 104
107, 127, 52Color 105
181, 208, 79Color 106
121, 83, 90Color 107
211, 12, 91Color 108
170, 210, 127Color 109
136, 81, 55Color 110
195, 19, 240Color 111
113, 102, 235Color 112
179, 156, 116Color 113
114, 12, 98Color 114
204, 168, 142Color 115
35, 142, 179Color 116
204, 169, 14Color 117
59, 133, 91Color 118
135, 19, 55Color 119
222, 176, 160Color 120
192, 203, 101Color 181
38, 124, 52Color 182
154, 61, 21Color 183
177, 219, 189Color 184
35, 174, 6Color 185
215, 250, 54Color 186
221, 185, 235Color 187
78, 222, 90Color 188
138, 247, 238Color 189
223, 137, 165Color 190
125, 44, 142Color 191
230, 124, 237Color 192
194, 172, 14Color 193
253, 166, 93Color 194
249, 108, 181Color 195
132, 174, 143Color 196
141, 5, 97Color 197
43, 123, 208Color 198
250, 123, 243Color 199
251, 229, 8Color 200
47, 150, 113Color 201
207, 124, 156Color 202
188, 242, 176Color 203
217, 169, 180Color 204
232, 138, 156Color 205
128, 118, 61Color 206
98, 161, 61Color 207
94, 98, 110Color 208
247, 141, 144Color 209
51, 99, 151Color 210
116, 184, 91Color 211
154, 7, 64Color 212
140, 23, 27Color 213
149, 64, 251Color 214
52, 6, 145Color 215
240, 245, 225Color 216
174, 94, 26Color 217
129, 244, 58Color 218
33, 205, 251Color 219
37, 27, 77Color 220
76, 155, 43Color 221
127, 60, 213Color 222
115, 194, 230Color 223
226, 152, 219Color 224
156, 30, 50Color 225
106, 108, 135Color 226
41, 80, 122Color 227
88, 38, 80Color 228
1, 209, 230Color 229
240, 149, 16Color 230
118, 147, 144Color 231
232, 36, 119Color 232
135, 101, 217Color 233
58, 115, 76Color 234
136, 72, 36Color 235
30, 84, 157Color 236
147, 224, 63Color 237
239, 155, 206Color 238
139, 252, 224Color 239
41, 20, 221Color 240
165, 128, 13Color 241
46, 117, 10Color 242
137, 20, 89Color 243
240, 226, 142Color 244
92, 223, 251Color 245
46, 240, 178Color 246
209, 170, 164Color 247
53, 82, 168Color 248
210, 253, 147Color 249
205, 18, 232Color 250
45, 161, 129Color 251
165, 59, 206Color 252
0, 236, 211Color 253
27, 96, 185Color 254
255, 226, 26Color 255
104, 136, 67Color 256
147, 224, 248Color 257
62, 14, 122Color 258
81, 159, 7Color 259
208, 47, 115Color 260
58, 236, 60Color 261
78, 255, 149Color 262
139, 212, 247Color 263
241, 124, 233Color 264
74, 196, 97Color 265
69, 35, 141Color 266
212, 174, 136Color 267
Preview
BRUGUER-ACRYLIC

62 representative colors.

Download .cns
Color RGB Values Label
68, 76, 74Black
89, 97, 102Medium Gray
163, 174, 175Pearl Gray
255, 255, 255Permanent White
80, 74, 71Tobacco
86, 74, 67Dun
211, 189, 161Light Beige
241, 222, 194Cream
141, 113, 91Ocher
161, 128, 90Suede
246, 222, 98Lemon Yellow
251, 247, 234Ivory
107, 66, 63Coach Red
117, 79, 97Magenta
182, 73, 65Vermilion
202, 96, 70Orange
44, 78, 109Cobalt Blue
46, 99, 146Navy Blue
41, 115, 161Bright Blue
74, 157, 207Anchor Blue
68, 76, 77Coach Green
70, 84, 75May Green
86, 107, 89Grass Green
100, 135, 95Spring Green
96, 100, 98Sand Gray
97, 76, 70Tuscan Brown
219, 213, 200Hazelnut
251, 251, 243Cotton White
229, 188, 100Gold Yellow
241, 221, 178Wheat Yellow
248, 237, 215Light Ivory
254, 251, 248Bone White
187, 80, 75Garnet
200, 127, 86Tile Red
99, 67, 69Granate Red
205, 123, 146Fuchsia
233, 228, 237Light Lilac
59, 91, 116Royal Blue
52, 91, 135Cantabric Blue
87, 170, 205Turquoise
160, 201, 232Sky Blue
90, 113, 93Galician Green
96, 113, 101Meadow Green
222, 224, 157Lime Green
248, 247, 237Carrara
200, 208, 213Gray
94, 82, 78Brown
207, 207, 207Nepal Beige
242, 240, 232Linen White
181, 79, 74Red
244, 227, 197Beige
252, 250, 242Parchment White
84, 99, 93Dark Green
235, 233, 176Pistachio Green
228, 241, 248Light Blue
Preview
BRUGUER-VIBRATIONS

36 representative colors.

Download .cns
Color RGB Values Label
255, 255, 255Absolute White
248, 246, 229Meringue
235, 229, 195Memories of Africa
208, 202, 191Silver Essence
129, 118, 97Loft
252, 247, 228Desert Air
233, 221, 190Touch of Cinnamon
204, 158, 82Desert Rose
131, 109, 93Clay Massage
81, 70, 63Temptation Truffle
248, 237, 230Rose Water
227, 173, 74Carnival Orange
215, 137, 50Tropic Orange
184, 160, 115Cream Coffee
100, 96, 90Chicago
229, 238, 246Frost Blue
135, 58, 59Carmine Kiss
167, 52, 55Passion Red
125, 66, 76Sexy Magenta
96, 64, 64Baroque Whim
244, 243, 192Mint Sorbet
237, 222, 103Dijon Yellow
206, 169, 53Old Gold
222, 191, 51Indian Curry
148, 146, 118Rain Green
204, 207, 59Refreshing Lime
167, 170, 109Wild Ivy
161, 187, 185Tropical Water
194, 198, 185Relaxing Eucalyptus
85, 96, 119Denim Blue
236, 240, 244Ceramic White
190, 50, 85Japanese Red
69, 68, 65Jet Black
231, 200, 91Sun
223, 224, 228Moon
202, 201, 183Eclipse
Preview
BRUGUER-WORLD COLORS

54 representative colors.

Download .cns
Color RGB Values Label
166, 166, 150Natural Pearl
195, 193, 179Intermediate Pearl
232, 231, 221Soft Pearl
35, 60, 90Atlantic Blue
150, 49, 57Pashmina Red
239, 232, 219Soft Beige
219, 211, 199Intermediate Beige
191, 181, 165Natural Beige
176, 147, 118Natural Brown
228, 210, 182Intermediate Brown
240, 231, 210Soft Brown
133, 50, 119Masai Fuchsia
234, 199, 135Natural Ocher
242, 219, 164Intermediate Ocher
247, 237, 211Soft Ocher
95, 131, 137Oasis Green
223, 163, 94Natural Peach
235, 195, 136Intermediate Peach
239, 215, 179Soft Peach
168, 43, 77Sari Magenta
244, 226, 136Natural Yellow
249, 240, 176Intermediate Yellow
250, 246, 209Soft Yellow
200, 157, 53Camel Yellow
163, 180, 93Natural Green
219, 229, 175Intermediate Green
236, 239, 212Soft Green
58, 35, 37Tropic Brown
117, 68, 111Natural Violet
199, 187, 219Intermediate Violet
229, 215, 232Soft Violet
122, 123, 93Bamboo Green
95, 80, 75Natural Stone
167, 149, 148Intermediate Stone
191, 183, 183Soft Stone
219, 131, 108Guava Juice
141, 194, 205Natural Turquoise
197, 217, 223Intermediate Turquoise
216, 227, 231Soft Turquoise
209, 213, 95Lime Green
203, 191, 215Lilac
167, 194, 223Natural Blue
197, 219, 239Intermediate Blue
223, 235, 245Soft Blue
71, 34, 73Capri Purple
235, 227, 207Natural White
248, 246, 231Intermediate White
239, 239, 239Bright White
236, 203, 165Natural Salmon
242, 219, 195Intermediate Salmon
247, 235, 223Soft Salmon
194, 139, 126Terracotta
209, 187, 184Intermediate Mallow
227, 209, 205Soft Mallow
Demonstration Videos

PyFCS demonstration videos

This section provides demonstration videos showing how to use the main PyFCS functionalities, including loading and editing existing fuzzy color spaces, image management, color space creation from palettes and images, and the Color Evaluation module.

01 Load & edit FCS

PyFCS: Loading and editing an existing Fuzzy Color Space

Demonstration of how to load an existing fuzzy color space, navigate through its visual and data structure, and modify its contents from the PyFCS graphical interface.

▶ Watch on YouTube
YouTube tutorial FCS navigation and editing
02 Image Manager

PyFCS: Image Manager

Overview of the Image Manager module and the utilities available for loading, displaying, managing, mapping and analysing images within PyFCS.

▶ Watch on YouTube
YouTube tutorial Image workflow
03 Palette creation

PyFCS: Creating a Fuzzy Color Space from a palette

Demonstration of how to create a fuzzy color space from a predefined or user-defined color palette, including the selection of representative colors and generation of the corresponding fuzzy color space.

▶ Watch on YouTube
YouTube tutorial Palette-based creation
04 Image-based creation

PyFCS: Creating a Fuzzy Color Space from an image

Demonstration of fuzzy color space creation from images, covering both the manual selection of representative colors and the automatic extraction workflow.

▶ Watch on YouTube
YouTube tutorial Manual and automatic creation
05 Color Evaluation

PyFCS: Color Evaluation module

Introduction to the Color Evaluation module, including perceptual color difference analysis, threshold-based interpretation, closest prototype ranking and graphical evaluation tools.

▶ Watch on YouTube
YouTube tutorial ΔE metrics and evaluation tools